3.17.4.1.30 Label (Opnum 36)

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

 [propget] HRESULT Label(
   [out, retval] BSTR* pbstrLabel
 );

pbstrLabel: A pointer to a BSTR that contains the application-defined string description of the message.

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 the represented Message.Label equals NULL:

    • Set the pbstrLabel output parameter to an empty BSTR ("").

  • Else:

    • The pbstrLabel output parameter MUST contain the value of the represented Message.Label.