This documentation is archived and is not being maintained.

CAtlHttpClientT::Navigate 

Call this method to perform an HTTP request.


bool Navigate(
   LPCTSTR szServer,
   LPCTSTR szPath,
   ATL_NAVIGATE_DATA * pNavData = NULL 
) throw(...);
bool Navigate(
   const CUrl* pUrl,
   ATL_NAVIGATE_DATA * pNavData = NULL 
) throw(...);
bool Navigate(
   LPCTSTR szURL,
   ATL_NAVIGATE_DATA * pNavData = NULL 
) throw(...);

Parameters

szServer

A string containing the server name, such as "www.microsoft.com", from which the request will be made.

szPath

A string containing the path of the desired item, relative to the server.

pUrl

The address of a CUrl object containing a description of the URL from which the request will be made.

szURL

A string containing the complete URL for the desired item. This string must be prefixed with the "http://" protocol specification.

pNavData

A pointer to an ATL_NAVIGATE_DATA or CAtlNavigateData object. This argument is used to specify navigation options.

If this argument is NULL, CAtlHttpClientT uses the navigation options provided by an internal instance of CAtlNavigateData. As a result, the settings provided by the CAtlNavigateData constructor will apply.

Returns true on success, false on failure.

Use these methods to perform HTTP client transactions. Each overload of the Navigate method can be used to retrieve responses from a URL. Using the URL and optional settings specified with the ATL_NAVIGATE_DATA structure, CAtlHttpClientT performs the HTTP request and stores any corresponding response.

A breaking change from previous versions, Navigate no longer passes user logon credentials for authentication unless the security zone settings allow it. This change increases the security of user credentials. This may break applications that relied on this non-secure method of authentication. This change only affects applications that use authentication objects supplied with AddAuthObj. If an authorization error occurs, an HTTP 401 code will be returned to the user's browser.

Show: