Export (0) Print
Expand All

CHttpConnection::OpenRequest 

This topic has been updated for Visual Studio 2005 SP1.

Call this member function to open an HTTP connection.


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 
);

Parameters

pstrVerb

A pointer to a string containing the verb to use in the request. If NULL, "GET" is used.

pstrObjectName

A pointer to a string containing the target object of the specified verb. This is generally a filename, an executable module, or a search specifier.

pstrReferer

A pointer to a string that specifies the address (URL) of the document from which the URL in the request (pstrObjectName) was obtained. If NULL, no HTTP header is specified.

dwContext

The context identifier for the OpenRequest operation. See Remarks for more information about dwContext.

ppstrAcceptTypes

A pointer to a null-terminated array of LPCTSTR pointers to strings indicating content types accepted by the client. If ppstrAcceptTypes is NULL, the servers interpret that the client only accepts documents of type "text/*" (that is, only text documents and not pictures or other binary files). The content type is equivalent to the CGI variable CONTENT_TYPE, which identifies the type of data for queries that have attached information, such as HTTP POST and PUT.

pstrVersion

A pointer to a string defining the HTTP version. If NULL, "HTTP/1.0" is used.

dwFlags

Any combination of the INTERNET_ FLAG_* flags. See the Remarks for a description of possible dwFlags values.

nVerb

A number associated with the HTTP request type. Can be one of the following:

HTTP request type nVerb value

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

A pointer to the CHttpFile object requested.

dwFlags can be one of the following:

Internet flag Description

INTERNET_FLAG_RELOAD

Forces a download of the requested file, object, or directory listing from the origin server, not from the cache.

INTERNET_FLAG_DONT_CACHE

Does not add the returned entity to the cache.

INTERNET_FLAG_MAKE_PERSISTENT

Adds the returned entity to the cache as a persistent entity. This means that standard cache cleanup, consistency checking, or garbage collection cannot remove this item from the cache.

INTERNET_FLAG_SECURE

Uses secure transaction semantics. This translates to using SSL/PCT and is only meaningful in HTTP requests

INTERNET_FLAG_NO_AUTO_REDIRECT

Used only with HTTP, specifies that redirections should not be automatically handled in CHttpFile::SendRequest.

Override the dwContext default to set the context identifier to a value of your choosing. The context identifier is associated with this specific operation of the CHttpConnection object created by its CInternetSession object. The value is returned to CInternetSession::OnStatusCallback to provide status on the operation with which it is identified. See the article Internet First Steps: WinInet for more information about the context identifier.

This section has been updated for Visual Studio 2005 SP1.

In the Smart Device version of this method, the default value of dwFlags is 0. The desktop version's default value is INTERNET_FLAG_EXISTING_CONNECT.

Community Additions

ADD
Show:
© 2014 Microsoft