CHttpConnection::OpenRequest

Artigo
06/10/2015

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 NULL, “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 NULL, nenhum cabeçalho HTTP é especificado.
dwContext
O identificador de contexto para a operação de OpenRequest . Consulte a seção comentários para obter mais informações sobre de dwContext.
ppstrAcceptTypes
Um ponteiro para uma matriz NULL- finalizada de ponteiros de LPCTSTR para cadeias de caracteres que indicam os tipos de conteúdo aceitos pelo cliente. Se ppstrAcceptTypes é NULL, servidores interpretar 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 POST HTTP e PUT.
pstrVersion
Um ponteiro para uma cadeia de caracteres que define a versão HTTP. Se NULL, “HTTP/1.0” é usado.
dwFlags
Qualquer combinação dos sinalizadores de INTERNET_ FLAG_*. Consulte a seção comentários para 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 nVerb

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 nVerb
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, de 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 cachê 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 é somente significativa 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 a CInternetSession::OnStatusCallback para fornecer o status na operação com que é identificado. Consulte o artigo Primeiras etapas da Internet: WinInet para obter mais informações sobre o identificador de contexto.

Exceções podem ser geradas com essa função.