Compartilhar via

Função WsRemoveMappedHeader (webservices.h)

  • Artigo

Remove todas as instâncias de um cabeçalho mapeado da mensagem.

Sintaxe

HRESULT WsRemoveMappedHeader(
  [in]           WS_MESSAGE          *message,
  [in]           const WS_XML_STRING *headerName,
  [in, optional] WS_ERROR            *error
);

Parâmetros

[in] message

A mensagem na qual definir o cabeçalho.

A mensagem pode estar em qualquer estado , mas WS_MESSAGE_STATE_EMPTY.

[in] headerName

O nome do cabeçalho mapeado a ser removido.

[in, optional] error

Especifica onde informações adicionais de 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 dos parâmetros estão incorretos.
Outros erros
Essa função pode retornar outros erros não listados acima.

Comentários

Uma mensagem pode conter informações adicionais específicas do transporte que não fazem parte do envelope de mensagem. Essas informações específicas de transporte podem ser expostas programaticamente como cabeçalhos do objeto Message. Essa função é usada para remover cabeçalhos mapeados do objeto de mensagem. Isso pode ser usado por uma implementação de canal personalizado para remover cabeçalhos mapeados antes de enviar 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