Função UrlApplySchemeA (shlwapi.h)

Determina um esquema para uma cadeia de caracteres de URL especificada e retorna uma cadeia de caracteres com um prefixo apropriado.

Sintaxe

LWSTDAPI UrlApplySchemeA(
  [in]      PCSTR pszIn,
  [out]     PSTR  pszOut,
  [in, out] DWORD *pcchOut,
            DWORD dwFlags
);

Parâmetros

[in] pszIn

Tipo: PCTSTR

Uma cadeia de caracteres terminada em nulo de comprimento máximo INTERNET_MAX_URL_LENGTH que contém uma URL.

[out] pszOut

Tipo: PTSTR

Um ponteiro para um buffer que, quando essa função retorna com êxito, recebe uma cadeia de caracteres terminada em nulo definida para a URL especificada por pszIn e convertida no esquema de padrãoformato ://URL_string.

[in, out] pcchOut

Tipo: DWORD*

O endereço de um valor definido como o número de caracteres no pszOut buffer. Quando a função retorna, o valor depende se a função é bem-sucedida ou retorna E_POINTER. Para outros valores retornados, o valor desse parâmetro não tem sentido.

dwFlags

Tipo: DWORD

Os sinalizadores que especificam como determinar o esquema. Os sinalizadores a seguir podem ser combinados.

URL_APPLY_DEFAULT

Aplique o esquema padrão se urlApplyScheme não puder determinar um. O prefixo padrão é armazenado no registro, mas normalmente é "http".

URL_APPLY_GUESSSCHEME

Tente determinar o esquema examinando pszIn.

URL_APPLY_GUESSFILE

Tente determinar uma URL de arquivo de pszIn.

URL_APPLY_FORCEAPPLY

Force UrlApplyScheme a determinar um esquema para pszIn.

Valor de retorno

Tipo: HRESULT

Retorna um valor de retorno COM padrão, incluindo o seguinte.

Observações

Se a URL tiver um esquema válido, a cadeia de caracteres não será modificada. No entanto, quase qualquer combinação de dois ou mais caracteres seguidos por dois-pontos será analisada como um esquema. Os caracteres válidos incluem algumas marcas de pontuação comuns, como ".". Se a cadeia de caracteres de entrada se ajustar a essa descrição, UrlApplyScheme poderá tratá-la como válida e não aplicar um esquema. Para forçar a função a aplicar um esquema a uma URL, defina os sinalizadores URL_APPLY_FORCEAPPLY e URL_APPLY_DEFAULT em dwFlags. Essa combinação de sinalizadores força a função a aplicar um esquema à URL. Normalmente, a função não será capaz de determinar um esquema válido. O segundo sinalizador garante que, se nenhum esquema válido puder ser determinado, a função aplicará o esquema padrão à URL.

Requisitos