CHttpFile:: AddRequestHeaders

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

BOOL &AddRequestHeaders (CStringamp;StrDWORDdwFlags= HTTP_ADDREQ_FLAG_ADD_IF_NEW);

Valor de retorno

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

Parâmetros

pstrHeaders

Um ponteiro para uma Cadeia de caracteres que contém o cabeçalho ou cabeçalhos para acrescentar ao pedido. Cada cabeçalho deve ser terminado por um par de CR/LF.

dwFlags

Modifica a semântica de novos cabeçalhos. Pode ser uma das seguintes:

• HTTP_ADDREQ_FLAG_COALESCE   Mescla cabeçalhos de mesmo nome, usando o sinalizador para adicionar o primeiro cabeçalho encontrado para o cabeçalho subseqüente. Por exemplo, "aceitar: texto / *" seguido por "aceitar: áudio / *" resulta na formação do único cabeçalho "aceitar: texto / *, áudio / *". É up to o aplicativo chamado para garantir um regime coerente com relação aos dados recebidos por solicitações enviadas com cabeçalhos transformados ou separados.
  
  
• HTTP_ADDREQ_FLAG_REPLACE   Executa um remover e adicionar a substituir o cabeçalho atual. O nome do cabeçalho será usado para remover o cabeçalho atual, e o valor total será usado para adicionar o novo cabeçalho. Se o valor de cabeçalho é vazio e o cabeçalho for encontrado, ele é removido. Se não for vazio, o valor de cabeçalho é substituído.
  
  
• HTTP_ADDREQ_FLAG_ADD_IF_&NEWnbsp;  Apenas adiciona o cabeçalho se ele já não existir. Se existir, um erro é retornado.
  
  
• HTTP_ADDREQ_FLAG_ADD   Usado com substituir. Adiciona o cabeçalho se ele não existir.

dwHeadersLen

O comprimento, em caracteres, de pstrHeaders. Se esta for L-1, em seguida, pstrHeaders será considerado terminada em zero e o comprimento é calculado.

str

Uma referência a um objeto de CString que contém o cabeçalho de solicitar ou cabeçalhos para ser adicionado.

Observações

Chame essa função de membro para adicionar um ou mais cabeçalhos de Solicitar HTTP para a Solicitar HTTP manipular.

AddRequestHeaders acrescenta cabeçalhos adicionais, de formato livre para o identificador de solicitação HTTP. Ele destina uso por clientes sofisticados que precisam de controle detalhado sobre a Solicitar exata enviada para o servidor HTTP.

&Notanbsp;  O aplicativo pode passar vários cabeçalhos em pstrHeaders ou str para chamar AddRequestHeaders 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 ou HTTP_ADDREQ_FLAG_REPLACE, apenas um cabeçalho pode ser fornecido em lpszHeaders.

Visão geral de CHttpFile |  Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CInternetFile