The NextHops method is received by the server in an RPC_REQUEST packet. In response, the server MUST return the represented OutgoingQueue.NextHops.

 [propget] HRESULT NextHops(
   [out, retval] VARIANT* pvNextHops
 );

pvNextHops: A pointer to a VARIANT that contains an array of zero or more strings (VT_ARRAY | VT_BSTR) that specify the routing addresses.

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

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

• If the ObjectIsInitialized instance variable is False:

  • The server MUST return MQ_ERROR_UNINITIALIZED_OBJECT (0xC00E0094), and MUST take no further action.

• The server MUST generate a QMMgmt Get Info event with the following inputs:

  • iPropID = PROPID_MGMT_QUEUE_NEXTHOPS

• If the rStatus return value is not equal to MQ_OK (0x00000000), the server MUST return rStatus and MUST take no further action.

• Else:

  • The pvNextHops output variable MUST be set to the value of the returned rPropVar.