CHttpConnection::OpenRequest

Artículo
06/10/2015

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
Puntero a una cadena que contiene el verbo que se va a utilizar en la solicitud. Si es NULL, se utiliza "GET".
pstrObjectName
Puntero a una cadena que contiene el objeto de destino del verbo especificado. Suele ser un nombre de archivo, un módulo ejecutable o un especificador de búsqueda.
pstrReferer
Puntero a una cadena que especifica la dirección (URL) del documento del que se obtuvo la dirección URL de la solicitud (pstrObjectName). Si es NULL, no se especifica ningún encabezado HTTP.
dwContext
Identificador de contexto para la operación OpenRequest. Vea la sección Comentarios para obtener más información sobre dwContext.
ppstrAcceptTypes
Puntero a una matriz terminada en null de punteros LPCTSTR a cadenas que indican los tipos de contenido que acepta el cliente. Si ppstrAcceptTypes es NULL, los servidores interpretan que el cliente solo acepta documentos de tipo “text/*” (es decir, solo 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 tienen información adjunta, como HTTP POST y PUT.
pstrVersion
Puntero a una cadena que define la versión de HTTP. Si es NULL, se utiliza "HTTP/1.0".
dwFlags
Cualquier combinación de las marcas INTERNET_ FLAG_*. Vea la sección Comentarios para obtener una descripción de los valores posibles de dwFlags.
nVerb
Número asociado al tipo de solicitud HTTP. Puede ser uno de los 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

Puntero al objeto CHttpFile solicitado.

Comentarios

dwFlags puede ser una de las siguientes:

Marca de Internet	Descripción
INTERNET_FLAG_RELOAD	Fuerza una descarga del archivo, el objeto o el listado de directorio solicitado del servidor de origen, no de la memoria 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 una entidad persistente. Esto significa que las operaciones estándar de limpieza de caché, comprobación de coherencia o recolección de elementos no utilizados no pueden quitar este elemento de la memoria caché.
INTERNET_FLAG_SECURE	Usa semántica de transacción segura. Esto se traduce en utilizar SSL/PCT y solo es significativo en solicitudes HTTP
INTERNET_FLAG_NO_AUTO_REDIRECT	Solo se utiliza con HTTP; especifica que las redirecciones no se deben controlar automáticamente en CHttpFile::SendRequest.

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

Se pueden producir excepciones con esta función.