CUrl::CreateUrl

Article
03/04/2013

Cette méthode construit une chaîne d'URL des champs composants d'un objet de boucle.

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

Paramètres

lpszUrl
Une mémoire tampon de chaîne pour contenir la chaîne complète d'URL.
pdwMaxLength
La longueur maximale de la mémoire tampon de chaîne de lpszUrl .
dwFlags
Spécifiez ATL_URL_ESCAPE pour convertir tous les caractères d'échappement dans le lpszUrl à leurs valeurs réelles.

Valeur de retour

Retourne RECTIFIENT en cas de réussite, FALSE en cas de échec.

Notes

Cette méthode ajoute ses champs individuels pour construire la chaîne complète d'URL au format suivant :

<scheme>: /<user>:<pass>@<domain>:<port><path><extra>

En appelant cette méthode, le paramètre d' pdwMaxLength doit initialement contenir la longueur maximale de la mémoire tampon de chaîne référencée par le paramètre de lpszUrl .La valeur du paramètre d' pdwMaxLength sera mise à jour avec la longueur réelle de la chaîne d'URL.

Exemple

Cet exemple illustre la création d'un objet et d'extraire de boucle sa chaîne d'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;