3.10.4.1.7 PathName (Opnum 13)

  • Article

The PathName method is received by the server in an RPC_REQUEST packet. In response, the server sets the path name indicating the queue that will be referenced by the MSMQQueueInfo class. Setting this value does not change the path name of a queue, but rather changes which queue is referenced.

 [propput] HRESULT PathName(
   [in] BSTR bstrPathName
 );

bstrPathName: A BSTR that specifies the path name of the referenced queue.

Return Values: The method MUST return S_OK (0x00000000).

When processing this call, the server MUST abide by the following contract:

  • Set refQueue.PathName to the value of the bstrPathName input parameter.

  • Set the QueueFormatName instance variable NULL.

  • Set the IsRefreshed, IsApplicationQueue, and IsQueueCreated instance variables to FALSE.

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