Retrieves the current status of the given command. The status indicates whether the command has been carried out on the object.
Syntax
HRESULT queryCommandState( BSTR cmdID, VARIANT_BOOL *pfRet );
Parameters
- cmdID
- String (BSTR) value that contains an identifier of a command. It can be any command identifier given in the list of Command Identifiers.
- pfRet
- Address of a VARIANT Boolean structure that receives VARIANT_TRUE if the given command has been carried out, VARIANT_FALSE if it has not, or NULL if the function cannot determine the status of the command.
Return Value
Returns S_OK if successful, or an error code otherwise.