Função InternetCreateUrlA (wininet.h)

Artigo
11/20/2024

Cria uma URL de suas partes componentes.

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 de 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 ser um ou mais 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 da estrutura URL_COMPONENTS 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 voltará para UTF-8.
ICU_USERNAME	Obsoleto – ignorado.

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 da estrutura URL_COMPONENTS 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 voltará 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 da URL buffer de lpszUrl, 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.

Valor de retorno

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

Observações

Ao especificar o 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_DEFAULTnecessário.

Observaçã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 do Microsoft Windows HTTP Services (WinHTTP).

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wininet.h
biblioteca	Wininet.lib
de DLL	Wininet.dll

Consulte também

tratando de recursos uniformes

do WinINet Functions

Compartilhar via