CHttpFile::AddRequestHeaders

Artigo
08/25/2010

telefonar Essa função de membro para adicionar um ou mais solicitações HTTP cabeçalhos para o HTTP solicitam alça.

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 seqüência de caracteres contendo o cabeçalho ou cabeçalhos para acrescentar a solicitação.Cada cabeçalho deve ser terminado por um emparelhar de CR/LF.
dwFlags
Modifica a semântica de novos cabeçalhos.Pode ser um dos seguintes:
- HTTP_ADDREQ_FLAG_COALESCE Mescla os cabeçalhos de mesmo nome, usando o sinalizar para adicionar o cabeçalho da primeiro encontrado para o cabeçalho subseqüente. Por exemplo, "aceitar: texto / * "seguido por" aceitar: áudio / * "resultados na formação de um único cabeçalho" aceitar: texto / *, áudio / * ".Ele é o aplicativo de chamada para garantir um esquema coeso em relação a dados recebidos pelo solicitações enviadas com cabeçalhos coalesced ou separados.
- HTTP_ADDREQ_FLAG_REPLACE Executa um remover e adicionar a substituir o cabeçalho corrente. O nome do cabeçalho será usado para remover o cabeçalho corrente e o valor total será usado para adicionar o novo cabeçalho.Se o valor do cabeçalho estiver vazio e o cabeçalho for encontrado, ele será removido.Se não estiver vazia, o valor do cabeçalho é substituído.
- HTTP_ADDREQ_FLAG_ADD_IF_NEW Adiciona o cabeçalho apenas se ele já não existir. Se houver um, um erro é retornado.
- HTTP_ADDREQ_FLAG_ADD Usado com substituir. Adiciona o cabeçalho se ela não existir.
dwHeadersLen
O comprimento, em caracteres, de pstrHeaders. Se esta for-1 L e, em seguida, pstrHeaders é considerado zero - finalizado e o comprimento é calculado.
str
Uma referência a um CString objeto que contém o cabeçalho de solicitação ou cabeçalhos a ser adicionado.

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário, 0.Se a telefonar falhar, o Win32 funcionar GetLastError pode ser chamado para determinar a causa do erro.

Comentários

AddRequestHeaders acrescenta cabeçalhos adicionais, formato disponível do identificador de solicitação HTTP. Ele é destinado ao uso por clientes sofisticados que precisam de controle detalhado sobre a exata solicitação enviada para o servidor HTTP.

Observação:
O aplicativo pode passar vários cabeçalhos em pstrHeaders ou str para um AddRequestHeaders chamar usando HTTP_ADDREQ_FLAG_ADD ou HTTP_ADDREQ_FLAG_ADD_IF_NEW. Se o aplicativo tenta remover ou substituir um cabeçalho usando HTTP_ADDREQ_FLAG_REMOVE or HTTP_ADDREQ_FLAG_REPLACE, apenas um cabeçalho pode ser fornecido em lpszHeaders.