PooledPipeline Object [C++]

Use this object to run a Microsoft Commerce Server 2002 pipeline configuration file. The pipeline may be an Order Processing pipeline (OPP).

The PooledPipeline object uses COM+ object pooling to greatly increase the loading speed of pipelines, where the contained pipeline components support object pooling. For more information about pooled pipelines, see Pooled Pipelines.

ProgID:   Commerce.PooledPipeline (Externally creatable)
COM Class Name:   CPooledPipeline
Type Library Name:   Microsoft Commerce 2002 Order Pipeline Type Library
DLL Name:   pipeline.dll
Threading Model:   Both

[C++]

COM Interface Name:   IPipeline
Interface ID Constant:   IID_IPipeline
Header File:   pipeline.h, mspu_guids.h

[C++]

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

[C++]

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.

[Visual Basic]

Method Description
Execute Executes the components in the pipeline.
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 Active Server Pages (ASP) page in which it is used rather that being held in Application or Sessions scope.

In general, use the PooledPipeline object only in production Web sites; use the MtsPipeline object when developing the site. If you use the PooledPipeline object during development, you will need to stop and restart Internet Information Services (IIS).

When you create custom poolable pipeline components, you must add the Component Object Model (COM) category, CATID_MSCSPIPELINE_POOLABLE, to the component to make it poolable. For more information about making a pipeline poolable, see Registering the ATL Component.

The PooledPipeline object is registered under COM+ as "transactions not supported." Use this pipeline where transactions are not needed. For more information about transactions and pipelines, see Pipeline Basics.

Copyright © 2005 Microsoft Corporation.
All rights reserved.