CHttpConnection::OpenRequest

Artigo
08/25/2010

Chame essa função de membro para em em aberto 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 seqüência de caracteres que contém o verbo a ser usado na solicitação.If NULO, "GET" é usado.
pstrObjectName
Um ponteiro para uma seqüência de caracteres que contém o objeto de destino de verbo especificado.Isso é geralmente um nome de arquivo, um módulo executável ou um especificador de Pesquisar.
pstrReferer
Um ponteiro para uma seqüência de caracteres que especifica o endereço (URL) do documento do qual a URL na solicitação de (pstrObjectName) foi obtida. If NULO, nenhum cabeçalho HTTP é especificado.
dwContext
O identificador de contexto para o OpenRequest operação. See Comentários para obter mais informações sobre o dwContext.
ppstrAcceptTypes
Um ponteiro para uma matriz de terminada com caractere nuloLPCTSTR ponteiros para cadeias de caracteres que indicam os tipos de conteúdo aceitos pelo cliente. If ppstrAcceptTypes is NULO, os servidores interpretam que o cliente só aceita documentos do tipo "texto / *" (ou seja, apenas o texto documentos e não imagens ou outros arquivos binário).O tipo de conteúdo é equivalente do CONTENT_TYPE variável CGI, que identifica o tipo de dados para consultas que anexou informações, sistema autônomo HTTP POST e PUT.
pstrVersion
Um ponteiro para uma seqüência de caracteres define a versão do HTTP.If NULO, "HTTP/1.0" é usado.
dwFlags
Qualquer combinação de sinalizadores INTERNET_ FLAG_ *.Consulte o Comentários para obter uma descrição dos possíveis dwFlags valores.
nVerb
Um número associado ao tipo de solicitação HTTP.Pode ser um dos seguintes:

Tipo de solicitação HTTP

nVerb valor

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	nVerb valor
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 CHttpFile objeto solicitado.

Comentários

dwFlags pode ser uma das seguintes opções:

sinalizar de Internet	Descrição
INTERNET_FLAG_RELOAD	Força um baixar do arquivo solicitado, objeto ou listagem de diretório do servidor de origem, e não a partir do cache.
INTERNET_FLAG_DONT_CACHE	Não adiciona a entidade retornada ao cache.
INTERNET_FLAG_MAKE_PERSISTENT	Adiciona a entidade retornada ao cache sistema autônomo uma entidade persistente.Isso significa que limpeza do cache padrão, a verificação de consistência ou coleta de lixo não pode remover este item do cache.
INTERNET_FLAG_SECURE	Usa segura semântica de transação.Isso se traduz em usando SSL/PCT e somente é significativo nas solicitações HTTP
INTERNET_FLAG_NO_AUTO_REDIRECT	Usado somente com HTTP, especifica que redirecionamentos devem não ser automaticamente tratados em CHttpFile::SendRequest.

Substituir o dwContext padrão para conjunto o identificador de contexto com um valor de sua escolha. O identificador de contexto está associado a esta operação específica do CHttpConnection objeto criado pelo seu CInternetSession objeto.O valor será retornado para CInternetSession::OnStatusCallback para fornecer status sobre a operação com o qual ela é identificada.Consulte o artigo Internet etapas primeira: WinInet para obter mais informações sobre o identificador de contexto.