CHttpFile::AddRequestHeaders

Artigo
02/25/2013

Chamar essa função de membro para adicionar um ou vários cabeçalhos de solicitação HTTP para o identificador da solicitação HTTP.

BOOL AddRequestHeaders(
   LPCTSTR pstrHeaders,
   DWORD dwFlags = HTTP_ADDREQ_FLAG_ADD_IF_NEW,
   int dwHeadersLen = -1 
);
BOOL AddRequestHeaders(
   CString& str,
   DWORD dwFlags = HTTP_ADDREQ_FLAG_ADD_IF_NEW 
);

Parâmetros

pstrHeaders
Um ponteiro para uma cadeia de caracteres que contém o cabeçalho ou os cabeçalhos para anexar à solicitação.Cada cabeçalho deve ser finalizado com um par de CR/LF.
dwFlags
Altera a semântica dos cabeçalhos.Pode ser um dos seguintes:
- HTTP_ADDREQ_FLAG_COALESCE mescla cabeçalhos de mesmo nome, usando o sinalizador para adicionar o primeiro cabeçalho encontrado ao cabeçalho subseqüente.Por exemplo, “aceitar: text/*” seguido por “aceitam: audio/*” resultados em training do único cabeçalho “aceitam: text/*, audio/*”.Até o aplicativo de chamada garantir que um esquema coesivo em relação a dados recebidos pelas solicitações enviadas com coalescido ou separar cabeçalhos.
- HTTP_ADDREQ_FLAG_REPLACE executa remover e adicioná-lo para substituir o cabeçalho atual.O nome do cabeçalho será usado para remover o cabeçalho atual, e o valor completa será usado para adicionar o novo cabeçalho.Se o cabeçalho- valor está vazia e o cabeçalho é encontrado, ele é removido.Se não vazio, o cabeçalho-valor é substituído.
- HTTP_ADDREQ_FLAG_ADD_IF_NEW adiciona somente o cabeçalho se ainda não existir.Se existir, um erro é retornado.
- HTTP_ADDREQ_FLAG_ADD usado com SUBSTITUI.Adiciona o cabeçalho se ele não existir.
dwHeadersLen
O comprimento de caracteres, em, pstrHeaders.Se este é -1L, então pstrHeaders será adotado zero para ser finalizado e o comprimento é calculado.
str
Uma referência a um objeto de CString que contém o cabeçalho ou os cabeçalhos de solicitação a serem adicionados.

Valor de retorno

Diferente de zero se com êxito; se não 0.Se a chamada falha, a função GetLastError Win32 pode ser chamado para determinar a causa do erro.

Comentários

AddRequestHeaders acrescenta adicionais, cabeçalhos de segmentação livre formato para o identificador da solicitação HTTP.Pretende-se para o uso de clientes sofisticados que precisam controle detalhado sobre a solicitação exata enviada para o servidor HTTP.

Observação
O aplicativo pode passar vários cabeçalhos em pstrHeaders ou em str para uma chamada de AddRequestHeaders usando HTTP_ADDREQ_FLAG_ADD ou HTTP_ADDREQ_FLAG_ADD_IF_NEW.Se o aplicativo tenta remova ou substitua um cabeçalho usando HTTP_ADDREQ_FLAG_REMOVE ou HTTP_ADDREQ_FLAG_REPLACE, somente um cabeçalho pode ser fornecido em lpszHeaders.