Compartir a través de

Función WsCreateMessageForChannel (webservices.h)

  • Artículo

Crea un mensaje para su uso con un canal especificado.

Sintaxis

HRESULT WsCreateMessageForChannel(
  [in]           WS_CHANNEL                *channel,
                 const WS_MESSAGE_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_MESSAGE                **message,
  [in, optional] WS_ERROR                  *error
);

Parámetros

[in] channel

Puntero a una estructura WS_CHANNEL que representa el canal 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 la estructura 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.

Código devuelto Descripción
E_OUTOFMEMORY
 Memoria insuficiente para completar la operación.
E_INVALIDARG
 Uno o más argumentos no son válidos.
Otros errores
Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

A diferencia de la función WsCreateMessage más general, WsCreateMessageForChannel garantiza que la versión del mensaje usada sea adecuada para el canal.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado webservices.h
Library WebServices.lib
Archivo DLL WebServices.dll