3.10.4.1.37 MulticastAddress (Opnum 43)

The MulticastAddress method is received by the server in an RPC_REQUEST packet. In response, the server returns the MulticastAddress instance variable, which specifies the multicast address on which the referenced queue listens.

 [propget] HRESULT MulticastAddress(
   [out, retval] BSTR* pbstrMulticastAddress
 );

pbstrMulticastAddress: A pointer to a BSTR that specifies the multicast address on which the referenced queue listens.

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 abide by the following contract:

  • If IsRefreshed is FALSE call Refresh (section 3.10.4.1.29).

  • If Refresh returns a value other than S_OK (0x00000000), return the HRESULT returned by Refresh and take no further action.

  • If IsApplicationQueue is True, set the pbstrMulticastAddress output parameter to the value of refQueue.MulticastAddress.

Else:

  • Set the pbstrMulticastAddress output parameter to the value of the MulticastAddress instance variable.

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