Función WsCreateMessage (webservices.h)

Crea un objeto de mensaje con las propiedades especificadas.

Sintaxis

HRESULT WsCreateMessage(
  [in]           WS_ENVELOPE_VERSION       envelopeVersion,
  [in]           WS_ADDRESSING_VERSION     addressingVersion,
                 const WS_MESSAGE_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_MESSAGE                **message,
  [in, optional] WS_ERROR                  *error
);

Parámetros

[in] envelopeVersion

Valor de enumeración WS_ENVELOPE_VERSION que especifica la versión del sobre del mensaje.

[in] addressingVersion

Un WS_ADDRESSING_VERSION que especifica la versión del direccionamiento del mensaje.

properties

Matriz de propiedades opcionales para el mensaje. Consulte WS_MESSAGE_PROPERTY.

El valor de este parámetro puede ser NULL, en cuyo caso el parámetro propertyCount debe ser 0 (cero).

[in] propertyCount

Número de propiedades de la matriz de propiedades .

message

Si se ejecuta correctamente, un puntero que recibe la dirección de una estructura de WS_MESSAGE que representa el nuevo mensaje.

Cuando ya no necesite esta estructura, debe liberarla llamando a WsFreeMessage.

[in, optional] error

Puntero a una estructura de WS_ERROR que recibe información de error adicional si se produce un error en la función.

Valor devuelto

Si la función se realiza correctamente, devuelve NO_ERROR; de lo contrario, devuelve un código de error HRESULT.

Comentarios

Un objeto de mensaje es el vehículo de entrega para servicios web de Windows. Se puede usar un único objeto de mensaje para enviar o recibir mensajes secuenciales. La reutilización de un objeto de mensaje de esta manera puede reducir las asignaciones de memoria. Cuando ya no necesite el mensaje, debe liberar la memoria llamando a WsFreeMessage. (Para obtener más información sobre la reutilización de objetos de mensaje, vea WsResetMessage ).

Si va a crear un mensaje para su uso con un canal determinado, use la función WsCreateMessageForChannel , que garantizará la versión de mensaje correcta para el canal.

Requisitos