CUrl::CreateUrl

Artículo
02/19/2013

Este método crea una cadena de dirección URL de los campos componentes de un objeto de CUrl.

inline BOOL CreateUrl(
   LPTSTR lpszUrl,
   DWORD* pdwMaxLength,
   DWORD dwFlags = 0 
) const throw( );

Parámetros

lpszUrl
Un búfer de cadena para contener la cadena completa de la dirección URL.
pdwMaxLength
La longitud máxima del búfer de cadena de lpszUrl .
dwFlags
Especifique ATL_URL_ESCAPE para convertir todos los caracteres de escape en lpszUrl a los valores reales.

Valor devuelto

Devuelve TRUE en correctamente, FALSE en el error.

Comentarios

Este método anexa sus campos individuales para construir la cadena completa de la dirección URL con el formato siguiente:

<esquema> : / <usuario> : <paso> @ <dominio> : <puerto> <ruta> <extensor>

Al llamar a este método, el parámetro de pdwMaxLength debe contener inicialmente la longitud máxima del búfer de cadena que hace referencia el parámetro de lpszUrl .El valor del parámetro de pdwMaxLength se actualizará con la longitud real de la cadena de dirección URL.

Ejemplo

Este ejemplo muestra la creación de un objeto y recuperar de CUrl su cadena de dirección URL

CUrl url;

// Set the CUrl contents
url.CrackUrl(_T("https://someone:secret@www.microsoft.com:8080/visualc/stuff.htm#contents"));

// Obtain the length of the URL string and allocate a buffer to 
// hold its contents
DWORD dwUrlLen = url.GetUrlLength() + 1;
TCHAR* szUrl = new TCHAR[dwUrlLen];

// Retrieve the contents of the CUrl object
url.CreateUrl(szUrl, &dwUrlLen, 0L);

// Cleanup
delete[] szUrl;