Share via

3.17.4.1.54 ConnectorTypeGuid (Opnum 60)

  • Article

The ConnectorTypeGuid method is received by the server in an RPC_REQUEST packet. In response, the server MUST set the represented Message.ConnectorTypeIdentifier.

 [propput] HRESULT ConnectorTypeGuid(
   [in] BSTR bstrGuidConnectorType
 );

bstrGuidConnectorType: A pointer to a BSTR that contains the GUID that will be stored with the message. The string MUST adhere to the following format, specified using ABNF.

 guid       = "{" dword-part "-" word-part "-" word-part 
              "-" 2byte-part "-" 6byte-part "}"
  
 dword-part = 2word-part
 word-part  = 2byte-part
 byte-part  = 2hex-digit
 hex-digit  = %x30-39 / %x41-46 / %x61-66

Return Values: The method MUST return S_OK (0x00000000) on success or an implementation-specific error HRESULT on failure.

When processing this call, the server MUST follow these guidelines:

  • If the bstrGuidConnectorType input parameter is NOT compliant with the format previously specified:

    • Return MQ_ERROR_ILLEGAL_PROPERTY_VALUE (0xC00E0018), and take no further action.

  • Set the represented Message.ConnectorTypeIdentifier to the value contained in the bstrGuidConnectorType input parameter.