CHttpConnection::OpenRequest

Artigo
02/25/2013

Chamar essa função de membro para abrir uma conexão HTTP.

CHttpFile* OpenRequest(
   LPCTSTR pstrVerb,
   LPCTSTR pstrObjectName,
   LPCTSTR pstrReferer = NULL,
   DWORD_PTR dwContext = 1,
   LPCTSTR* ppstrAcceptTypes = NULL,
   LPCTSTR pstrVersion = NULL,
   DWORD dwFlags = INTERNET_FLAG_EXISTING_CONNECT 
);
CHttpFile* OpenRequest(
   int nVerb,
   LPCTSTR pstrObjectName,
   LPCTSTR pstrReferer = NULL,
   DWORD_PTR dwContext = 1,
   LPCTSTR* ppstrAcceptTypes = NULL,
   LPCTSTR pstrVersion = NULL,
   DWORD dwFlags = INTERNET_FLAG_EXISTING_CONNECT 
);

Parâmetros

pstrVerb
Um ponteiro para uma cadeia de caracteres que contém o verbo para usar na solicitação.Se NULO, “GET” é usado.
pstrObjectName
Um ponteiro para uma cadeia de caracteres que contém o objeto alvo o verbo especificado.Isso é geralmente um nome de arquivo executável, módulo, ou um especificador de pesquisa.
pstrReferer
Um ponteiro para uma cadeia de caracteres que especifica o endereço (URL) do documento de que a URL na solicitação (pstrObjectName) foi obtido.Se NULO, nenhum cabeçalho HTTP é especificado.
dwContext
O identificador de contexto para a operação de OpenRequest .Consulte Comentários para obter mais informações sobre dwContext.
ppstrAcceptTypes
Um ponteiro para uma matriz NULL- finalizada de ponteiros de LPCTSTR para cadeias de caracteres que indicam tipos de conteúdo aceitou pelo cliente.Se os ppstrAcceptTypes são NULO, servidores interpretam que o cliente aceita apenas documentos do tipo “text/*” (isto é, somente documentos de texto e não imagens ou outros arquivos binários.)O tipo de conteúdo é equivalente à variável CONTENT_TYPE de cgi, que identifica o tipo de dados para consultas que anexaram informações, como um POST HTTP e PUT.
pstrVersion
Um ponteiro para uma cadeia de caracteres que define a versão HTTP.Se NULO, “HTTP/1.0” é usado.
dwFlags
Qualquer combinação dos sinalizadores de INTERNET_ FLAG_*.Consulte Comentários para obter uma descrição dos possíveis valores de dwFlags .
nVerb
Um número associado com o tipo de solicitação HTTP.Pode ser um dos seguintes:

Tipo de solicitação HTTP

Valor denVerb

HTTP_VERB_POST

0

HTTP_VERB_GET

1

HTTP_VERB_HEAD

2

HTTP_VERB_PUT

3

HTTP_VERB_LINK

4

HTTP_VERB_DELETE

5

HTTP_VERB_UNLINK

6

Tipo de solicitação HTTP	Valor denVerb
HTTP_VERB_POST	0
HTTP_VERB_GET	1
HTTP_VERB_HEAD	2
HTTP_VERB_PUT	3
HTTP_VERB_LINK	4
HTTP_VERB_DELETE	5
HTTP_VERB_UNLINK	6

Valor de retorno

Um ponteiro para o objeto de CHttpFile aplicativo.

Comentários

dwFlags pode ser um dos seguintes:

Sinalizador de Internet	Descrição
INTERNET_FLAG_RELOAD	Força um download do arquivo, do objeto, ou solicitada de listagem de diretório do servidor de origem, não do cache.
INTERNET_FLAG_DONT_CACHE	Não adiciona o objeto retornado para o cache.
INTERNET_FLAG_MAKE_PERSISTENT	Adiciona o objeto retornado para o cache como uma entidade persistente.Isso significa que padrão armazenar em cache a limpeza, consistência que verifica, ou coleta de lixo não pode remover este item do cache.
INTERNET_FLAG_SECURE	Usos protegem a semântica de transação.Isso converte a usar SSL/PCT e só é significativo em solicitações HTTP
INTERNET_FLAG_NO_AUTO_REDIRECT	Usado somente com HTTP, que especifica as reorientações não devem ser tratados automaticamente em CHttpFile::SendRequest.

Substitua a opção de dwContext para definir o identificador de contexto a um valor de sua escolha.O identificador de contexto é associado com esta operação específica do objeto de CHttpConnection criado pelo seu objeto de CInternetSession .O valor é retornado para CInternetSession::OnStatusCallback para fornecer o status da operação com que é identificado.Consulte o artigo Primeiras etapas da Internet: WinInet para obter mais informações sobre o identificador de contexto.