Função InternetCreateUrlA (wininet.h)

  • Artigo

Cria uma URL de suas partes de componente.

Sintaxe

BOOL InternetCreateUrlA(
  [in]      LPURL_COMPONENTSA lpUrlComponents,
  [in]      DWORD             dwFlags,
  [out]     LPSTR             lpszUrl,
  [in, out] LPDWORD           lpdwUrlLength
);

Parâmetros

[in] lpUrlComponents

Ponteiro para uma estrutura URL_COMPONENTS que contém os componentes dos quais criar a URL.

[in] dwFlags

Controla a operação dessa função. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
ICU_ESCAPE
 Converte todos os caracteres não seguros em suas sequências de escape correspondentes na cadeia de caracteres de caminho apontada pelo membro lpszUrlPath e em lpszExtraInfo a cadeia de caracteres de informações extras apontada pelo membro do URL_COMPONENTS estrutura apontada pelo parâmetro lpUrlComponents .

A versão Unicode do InternetCreateUrl primeiro tentará converter usando a página de código do sistema. Se isso falhar, ele retornará para UTF-8.
ICU_USERNAME
 Obsoleto – ignorado.

[out] lpszUrl

Ponteiro para um buffer que recebe a URL.

[in, out] lpdwUrlLength

Ponteiro para uma variável que especifica o tamanho do buffer lpszUrl da URL, em TCHARs. Quando a função retorna, esse parâmetro recebe o tamanho da cadeia de caracteres de URL, excluindo o terminador NULL. Se GetLastError retornar ERROR_INSUFFICIENT_BUFFER, esse parâmetro receberá o número de bytes necessários para manter a URL criada.

Retornar valor

Retorna TRUE se a função for bem-sucedida ou FALSE caso contrário. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Ao especificar esquema na estrutura URL_COMPONENTS passada para lpUrlComponents, se lpszScheme não for NULL, ele será usado para o esquema. Se lpszScheme for NULL, o esquema poderá ser especificado usando a enumeração INTERNET_SCHEME definindo nScheme para o INTERNET_SCHEME ou INTERNET_SCHEME_DEFAULT necessários.

Nota O WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações ou serviços de servidor, use Os Serviços HTTP do Microsoft Windows (WinHTTP).
 

Observação

O cabeçalho wininet.h define InternetCreateUrl como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wininet.h
Biblioteca Wininet.lib
DLL Wininet.dll

Confira também

Manipulando localizadores de recursos uniformes

Funções WinINet