The statusRequest ATL COM module is capable of
querying the status of a reference object
querying the status of a reference object
API browser of statusRequest430 COM module
IStatusRequest::AddQueryObject method | |||
---|---|---|---|
Adds one request object of a certain type whose status is requested.
There is a maximum of 100 such objects that can be added. |
|||
C/C++ calling syntax | |||
HRESULT AddQueryObject( | ObjectType
BSTR DATE long VARIANT_BOOL |
eObjectType,
bstrRequestID, dRequestDate, lRequestTimestamp, *pbStatus); |
|
Calling argument description | |||
[in] ObjectType | eObjectType | Defines the type of the object request | |
[in] BSTR | bstrRequestID | The request ID is the identification of a request of that type (e.g. the invoice or reminder identification).
This is one of 3 identifiers that form an object reference. The request ID is always defined by the sender. |
|
[in] DATE | dRequestDate | The request date is the date of a request of that type (e.g. the invoice or reminder date).
This is one of 3 identifiers that form an object reference. The request date is always defined by the sender. |
|
[in] long | lRequestTimestamp | The request timestamp is a UNIX timestamp defined at the moment of the XML infoset generation.
This is one of 3 identifiers that form an object reference. The request timestamp was returned when the request was generated for the first time. |
|
[out, retval] VARIANT_BOOL | *pbStatus | Return status of the method. If pbStatus is VARIANT_FALSE then an error occurred and GetAbortInfo should be called to retrieve the error string. | |
C/C++ return value | |||
S_OK | This value is returned if the function call was successful or if the return value of a boolean method signalling a true value. In this case the VARIANT_BOOL is set to VARIANT_TRUE. | ||
S_FALSE | This is the return value of a boolean method signalling a false return value. In this case the VARIANT_BOOL is set to VARIANT_FALSE. | ||
E_name | This value is returned if the function call was unsuccessful and an error exception was generated. Note that if you are using SmartPointers an exception is thrown under these conditions. | ||