AtlCombineUrl

Article
12/01/2015

Call this function to combine a base URL and a relative URL into a single, canonical URL.

Syntax

      inline BOOL AtlCombineUrl(
   LPCTSTR szBaseUrl,
   LPCTSTR szRelativeUrl,
   LPTSTR szBuffer,
   DWORD* pdwMaxLength,
   DWORD dwFlags = 0 
) throw( );

Parameters

szBaseUrl
The base URL.
szRelativeUrl
The URL relative to the base URL.
szBuffer
Caller-allocated buffer to receive the canonicalized URL.
pdwMaxLength
Pointer to a variable that contains the length in characters of szBuffer. If the function succeeds, the variable receives the number of characters written to the buffer not including the terminating null character. If the function fails, the variable receives the required length in bytes of the buffer including space for the terminating null character.
dwFlags
Flags controlling the behavior of this function. See ATL_URL Flags.

Return Value

Returns TRUE on success, FALSE on failure.

Remarks

Behaves like the current version of InternetCombineUrl but does not require WinInet or Internet Explorer to be installed.

Requirements

Header: atlutil.h

Partager via