Compartilhar via

Função WsInitializeMessage (webservices.h)

  • Artigo

Essa função inicializa os cabeçalhos da mensagem em preparação para processamento. Depois que uma mensagem for inicializada, um aplicativo poderá adicionar cabeçalhos adicionais. Com êxito, a mensagem está em WS_MESSAGE_STATE_INITIALIZED estado. Se a função falhar, nenhuma transição de estado ocorrerá.

Sintaxe

HRESULT WsInitializeMessage(
  [in]           WS_MESSAGE                *message,
  [in]           WS_MESSAGE_INITIALIZATION initialization,
  [in, optional] WS_MESSAGE                *sourceMessage,
  [in, optional] WS_ERROR                  *error
);

Parâmetros

[in] message

Um ponteiro para o objeto Message a ser inicializado. A Mensagem deve ser uma instância de objeto WS_MESSAGE válida retornada por WsCreateMessage ou WsCreateMessageForChannel e pode não ser NULL.

[in] initialization

Define a inicialização da mensagem.

Nota Se o valor de inicialização for definido como WS_REPLY_MESSAGE ou WS_FAULT_MESSAGE a mensagem será endereçada automaticamente.
 

[in, optional] sourceMessage

Um ponteiro para um objeto de mensagem usado para inicializar o parâmetro de mensagem . Esse valor deve ser NULL, a menos que o parâmetro de inicialização tenha o valor de WS_DUPLICATE_MESSAGE, WS_REPLY_MESSAGE ou WS_FAULT_MESSAGE.

[in, optional] error

Um ponteiro para um objeto WS_ERROR em que informações adicionais sobre o erro devem ser armazenadas se a função falhar.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
E_OUTOFMEMORY
 Ficou sem memória.
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

O remetente inicial de uma mensagem deve adicionar um cabeçalho de ação à mensagem usando WsSetHeader.

Essa API deve ser chamada antes que WsWriteEnvelopeStart ou WsWriteMessageStart seja chamado para a mensagem.

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