CHttpFile::AddRequestHeaders
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.
Dica
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.
Requisitos
Cabeçalho: afxinet.h