PooledPipeline Object

For the latest version of Commerce Server 2007 Help, see the Microsoft Web site.

Use this object to run a Commerce Server pipeline.

The PooledPipeline object uses COM+ object pooling to increase the loading speed of pipelines, where the pipeline components that it contains support object pooling.

ProgID:

Commerce.PooledPipeline (Externally creatable)

COM Class Name:

CPooledPipeline

Type Library Name:

Microsoft Commerce Server Order Pipeline Type Library

DLL Name:

pipeline.dll

Threading Model:

Both

COM Interface Name:

IPipeline

Interface ID Constant:

IID_IPipeline

Header File:

pipeline.h

In C++, use the IPipeline interface to access the properties and methods of the PooledPipeline object.

Because this object is primarily intended for use within ASP script, access from C++ will not be common.

Methods

Method

Description

Execute

Executes the components in the pipeline as configured by the LoadPipe method.

LoadPipe

Loads a pipeline configuration file (.pcf) into the pipeline.

SetLogFile

Identifies the file in which to log pipeline events.

Remarks

The PooledPipeline object should be created on each Web page that it is used in instead than being held in Application or Session scope.

Generally, use the PooledPipeline object only in production Web sites; use the MtsPipeline object when you are developing the site. If you use the PooledPipeline object during development, you must stop and restart Internet Information Services (IIS) in order to force the .pcf files to be re-read when you change them.

To create a custom poolable pipeline component, add the GUID 4cb33c86-58fa-4e10-97a8-f19aff3b81d9 to the pipeline component's implemented categories.

The PooledPipeline object is registered under COM+ as "transactions not supported." Use this pipeline if transactions are not needed.

See Also

Other Resources

COM Object Reference