IPredModelBuilder::get_Status
.gif "Ee811010.c++_off(en-US,CS.10).gif")
.gif "Ee811010.vb_on(en-US,CS.10).gif")
The Status property is a read-only ePredBuildStatus enumerated type. This property indicates the current status of a model build thread.
Definition
HRESULT IPredModelBuilder::get_Status(longlBuildID,ePredBuildStatus*peStatus);
Parameters
lBuildID
[in] A long that contains the build identifier used to select a specific build thread.
peStatus
[out, retval] A pointer to an ePredBuildStatus enumerated type that indicates the status of the specified thread.
Return Values
This method returns an HRESULT indicating whether it completed successfully. See the following Error Values section for more details. The IErrorInfo interface provides more specific error information.
Error Values
This method returns 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.
Remarks
The following table defines the possible values for the ePredBuildStatus enumerated build states.
| Name | Value | Description |
| PredBldRunning | 0 | Is currently running. |
| PredBldPaused | 1 | Is paused. |
| PredBldShuttingDown | 2 | Is shutting down in response to the Stop method. |
BuildIDs become invalid when a build is finished, either successfully or due to failure. For status information on finished builds, view the event log.
Initiate the build thread using the Start method before you access the thread using the Status property.
For more information about memory ownership issues related to COM property and method parameters, see Managing COM Parameter Memory.
The peStatus parameter contains valid data only if the property is accessed successfully.