CUrl::CreateUrl

Статья
06/09/2015

Этот метод создает строку url-адреса из полей объекта скручиваемости.

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

Параметры

lpszUrl
Буфер строк, чтобы гарантировать полную строку url-адреса.
pdwMaxLength
Максимальная длина буфера строки lpszUrl.
dwFlags
Укажите ATL_URL_ESCAPE, чтобы преобразовать все escape-символы в lpszUrl к реальным их значения.

Возвращаемое значение

Возвращает TRUE в случае успешного выполнения ЛОЖНОМ при сбое.

Заметки

Этот метод добавляет отдельных полей для построения полную строку url-адреса с использованием следующий формат:

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

При вызове этого метода значение параметра pdwMaxLength должен изначально содержать максимальную длину буфера строки, на который ссылается параметр lpszUrl. Значение параметра pdwMaxLength будет обновлено с фактической длиной строки url-адреса.

Пример

В этом образце демонстрируется создание объектов и восстановление скручиваемости его строка, представляющая 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;