IMicroPipeline::Execute
.gif "Ee799229.c++_off(en-US,CS.10).gif")
.gif "Ee799229.vb_on(en-US,CS.10).gif")
Use this method to run the pipeline component specified by the SetComponent method.
Definition
HRESULT IMicroPipeline::Execute(IDispatch*pdispOrder,IDispatch*pdispContext,longlFlags,long*pErrorLevel);
Parameters
pdispOrder
[in] A pointer to the IDispatch interface of a Dictionary object. The Dictionary object is the Order dictionary that the pipeline component will run.
pdispContext
[in] A pointer to the IDispatch interface of a Dictionary object. The Context dictionary for the pipeline component to be run.
lFlags
[in] A long integer. Reserved for future use. Must be set to zero (0).
pErrorLevel
[out,retval] A pointer to a long that returns the error level.
Return Values
This method returns an HRESULT indicating whether or not it completed successfully. See the Error Values section for more details.
Error Values
This method returns the message S_OK (0x00000000) to indicate success and standard COM HRESULT error values to indicate failure. For more information about standard COM errors, see Standard COM Errors. Additional information may be available using the global Err object, which can be accessed using the API function GetErrorInfo. In particular, the GetDescription method of the IErrorInfo interface may return a text description of the error.
In addition, the pErrorLevel parameter is set to one of the following three values:
| Value | Description |
| 1 | The pipeline component ran successfully. |
| 2 | The pipeline component raised a warning. Generally, these are basket or user errors that would be reported to the user through the ASP page. |
| 3 | The pipeline component failed to run. |
Remarks
The pErrorLevel parameter points to valid data only if the method completes successfully.
Be sure to release the IMicroPipeline interface when finished.
For more information about memory ownership issues related to COM property and method parameters, see Managing COM Parameter Memory.