Função WsCreateMessageForChannel (webservices.h)

  • Artigo

Cria uma mensagem para uso com um canal especificado.

Sintaxe

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

Ponteiro para uma estrutura WS_CHANNEL que representa o canal da mensagem.

properties

Uma matriz de propriedades opcionais para a mensagem. Confira WS_MESSAGE_PROPERTY.

O valor desse parâmetro pode ser NULL; nesse caso, o parâmetro propertyCount deve ser 0 (zero).

[in] propertyCount

O número de propriedades na matriz de propriedades .

message

Em caso de êxito, um ponteiro que recebe o endereço da estrutura WS_MESSAGE que representa a nova mensagem.

Quando você não precisar mais dessa estrutura, deverá liberá-la chamando WsFreeMessage.

[in, optional] error

Ponteiro para uma estrutura WS_ERROR que recebe informações de erro adicionais se a função falhar.

Retornar valor

Se a função for bem-sucedida, ela retornará NO_ERROR; caso contrário, ele retornará um código de erro HRESULT.

Código de retorno Descrição
E_OUTOFMEMORY
 Memória insuficiente para concluir a operação.
E_INVALIDARG
 Um ou mais argumentos são inválidos.
Outros erros
Essa função pode retornar outros erros não listados acima.

Comentários

Em contraste com a função WsCreateMessage mais geral, WsCreateMessageForChannel garante que a versão da mensagem usada seja apropriada para o canal.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho webservices.h
Biblioteca WebServices.lib
DLL WebServices.dll