Share via

3.17.4.1.19 SourceMachineGuid (Opnum 25)

  • Article

The SourceMachineGuid method is received by the server in an RPC_REQUEST packet. In response, the server MUST return the represented Message.SourceMachineIdentifier.

 [propget] HRESULT SourceMachineGuid(
   [out, retval] BSTR* pbstrGuidSrcMachine
 );

pbstrGuidSrcMachine: A pointer to a BSTR that contains the GUID identifier of the computer that sent 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:

  • Set the pbstrGuidSrcMachine output parameter to the value of the represented Message.SourceMachineIdentifier.