Compartilhar via

Função WsCreateMessage (webservices.h)

  • Artigo

Cria um objeto de mensagem com as propriedades especificadas.

Sintaxe

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

Um WS_ENVELOPE_VERSION valor de enumeração que especifica a versão do envelope para a mensagem.

[in] addressingVersion

Um WS_ADDRESSING_VERSION que especifica a versão do endereçamento para a mensagem.

properties

Uma matriz de propriedades opcionais para a mensagem. Consulte 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 de uma 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 de 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 retorna 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

Um objeto de mensagem é o veículo de entrega dos Serviços Web do Windows. Um único objeto de mensagem pode ser usado para enviar ou receber mensagens sequenciais. Reutilizando um objeto de mensagem dessa forma pode reduzir as alocações de memória. Quando você não precisar mais da mensagem, deverá liberar a memória chamando WsFreeMessage. (Para obter mais informações sobre como reutilizar objetos de mensagem, consulte WsResetMessage .)

Se você estiver criando uma mensagem para uso com um canal específico, use a função WsCreateMessageForChannel , que garantirá a versão correta da mensagem 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