3.12.4.1.8 PathName (Opnum 14)

The PathName method is received by the server in an RPC_REQUEST packet. In response, the server returns the path name that identifies the Queues that are represented by this object.

 [propget] HRESULT PathName(
   [out, retval] BSTR* pbstrPathName
 );

pbstrPathName: A pointer to a BSTR that contains the UNC or DNS path name of the queue.

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 Queue.PathName is NULL:

    • Set the pbstrPathName output parameter to an empty string

  • Otherwise, set the pbstrPathName output parameter to the value of Queue.PathName.

  • Return S_OK (0x00000000), and take no further action.