Função WsResetMessage (webservices.h)

  • Artigo

Define o estado mensagem de volta como WS_MESSAGE_STATE_EMPTY. Nesse estado, o objeto Message pode ser reutilizado.

Sintaxe

HRESULT WsResetMessage(
  [in]           WS_MESSAGE *message,
  [in, optional] WS_ERROR   *error
);

Parâmetros

[in] message

Um ponteiro para o objeto Message a ser redefinido.

[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_INVALIDARG
 Um ou mais argumentos são inválidos.

Comentários

Quando uma mensagem é redefinida, seu heap subjacente é redefinido.

Reutilizando um objeto de mensagem para receber ou enviar várias mensagens geralmente é mais eficiente do que criar e liberar o objeto de mensagem para cada 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