CHttpConnection::OpenRequest

Artículo
02/19/2013

Llame a esta función miembro para abrir una conexión 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
Un puntero a una cadena que contiene el verbo para utilizar en la solicitud.Si se utiliza NULL, como GET “”.
pstrObjectName
Un puntero a una cadena que contiene el objeto de destino del verbo especificado.Esto normalmente un nombre de archivo, un módulo ejecutable, o un especificador de búsqueda.
pstrReferer
Un puntero a una cadena que especifica la dirección (URL) del documento de que obtuvieron a la dirección URL de la solicitud (pstrObjectName).si se especifica NULL, ningún encabezado HTTP.
dwContext
El identificador del contexto de la operación de OpenRequest .Vea Comentarios para obtener más información sobre dwContext.
ppstrAcceptTypes
Puntero a una matriz terminado en null de punteros de LPCTSTR a cadenas que indican los tipos de contenido aceptados por el cliente.Si los ppstrAcceptTypes son NULL, los servidores interpretan que el cliente sólo acepta documentos de tipo “text/*” (es decir, los documentos de texto y no imágenes u otros archivos binarios).El tipo de contenido es equivalente a la variable CONTENT_TYPE de CGI, que identifica el tipo de datos para las consultas que han adjuntado información, como HTTP POST y PUT.
pstrVersion
Un puntero a una cadena que define la versión de HTTP.si se utiliza NULL, “HTTP/1.0”.
dwFlags
Cualquier combinación de las marcas de INTERNET_ FLAG_*.Vea Comentarios para obtener una descripción de los valores posibles de dwFlags .
nVerb
Un número asociado al tipo de solicitud HTTP.Puede ser una de las siguientes:

Tipo de solicitud HTTP

Valor de 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 solicitud HTTP	Valor de 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 devuelto

Un puntero al objeto de CHttpFile solicitado.

Comentarios

dwFlags puede ser:

Indicador de internet	Descripción
INTERNET_FLAG_RELOAD	Fuerza una descarga del archivo, objetos, o de la lista de directorios solicitado del servidor de origen, no de la caché.
INTERNET_FLAG_DONT_CACHE	No agrega la entidad devuelta a la memoria caché.
INTERNET_FLAG_MAKE_PERSISTENT	Agrega la entidad devuelta a la memoria caché como entidad persistente.Esto significa que estándar almacena en caché la limpieza, comprobación de coherencia, o la recolección de elementos no utilizados no puede quitar este elemento de la memoria caché.
INTERNET_FLAG_SECURE	Usa la semántica segura de la transacción.Esto convierte a utilizar SSL/PCT y solo es significativo en solicitudes HTTP
INTERNET_FLAG_NO_AUTO_REDIRECT	Sólo se utiliza con HTTP, especifica que las redirecciones no deben automáticamente controlar en CHttpFile:: SendRequest.

Reemplace el valor predeterminado de dwContext para establecer el identificador de contexto a un parámetro de elegir.El identificador de contexto es asociado a esta operación específica del objeto de CHttpConnection creado por el objeto de CInternetSession .El valor se devuelve a CInternetSession:: OnStatusCallback para proporcionar el estado de la operación a la que se identifica.Vea el artículo Primeros pasos de internet: WinInet para obtener más información sobre el identificador del contexto.