CUrl::CreateUrl

Artigo
08/25/2010

Este método constrói uma seqüência de caracteres de URL de componente campos um objeto de ondulação.

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

Parâmetros

lpszUrl
Um buffer de cadeia de caracteres para armazenar a seqüência de caracteres da URL completa.
pdwMaxLength
O comprimento máximo do lpszUrl buffer de cadeia de caracteres.
dwFlags
Especificar ATL_URL_ESCAPE para converter todos os caracteres de escape em lpszUrl para seus valores reais.

Valor de retorno

Retorna verdadeiro sucesso, falso em caso de falha.

Comentários

Esse método anexa seus campos individuais ao construir a seqüência de caracteres da URL completa usando o seguinte formato:

<scheme>://<usuário>:<pass>@<domínio>:<porta><caminho><extra>

Ao chamar esse método, o pdwMaxLength parâmetro inicialmente deve conter o comprimento máximo do buffer de cadeia de caracteres referenciado pela lpszUrl parâmetro.O valor de pdwMaxLength parâmetro será atualizado com o tamanho real de seqüência de caracteres da URL.

Exemplo

Este exemplo demonstra a criação de um objeto de ondulação e recuperar sua seqüência de 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;