Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

WsGetMessageProperty function (webservices.h)

Retrieves a specified Message object property. The property to retrieve is identified by a WS_MESSAGE_PROPERTY_ID input parameter.

Syntax

HRESULT WsGetMessageProperty(
 [in] WS_MESSAGE *message,
 [in] WS_MESSAGE_PROPERTY_ID id,
 void *value,
 [in] ULONG valueSize,
 [in, optional] WS_ERROR *error
);

Parameters

[in] message

A pointer to a Message object containing the desired property. This parameter must be a valid WS_LISTENER object.

[in] id

This is a WS_MESSAGE_PROPERTY_ID enumerator value that identifies the desired property.

value

A reference to a location for storing the retrieved property value. The pointer must have an alignment compatible with the type of the property.

[in] valueSize

The byte-length buffer size allocated by the caller to store the retrieved property value.

[in, optional] error

A pointer to a WS_ERROR object where additional information about the error should be stored if the function fails.

Return value

This function can return one of these values.

Return code Description
E_INVALIDARG
The property id was not supported for this object or the specified buffer was not large enough for the value.
E_OUTOFMEMORY
The application has run out of memory.
Other Errors
This function may return other errors not listed above.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header webservices.h
Library WebServices.lib
DLL WebServices.dll

Feedback

Was this page helpful?

Additional resources