Share via

Função TranslateURLW (intshcut.h)

  • Artigo

Aplica traduções comuns a uma determinada cadeia de caracteres de URL, criando uma nova cadeia de caracteres de URL.

Sintaxe

INTSHCUTAPI HRESULT TranslateURLW(
        PCWSTR pcszURL,
        DWORD  dwInFlags,
  [out] PWSTR  *ppszTranslatedURL
);

Parâmetros

pcszURL

Tipo: PCTSTR

O endereço da cadeia de caracteres de URL a ser convertida.

dwInFlags

Tipo: DWORD

Os sinalizadores de bit que especificam como a cadeia de caracteres de URL deve ser traduzida. Esse valor pode ser uma combinação do seguinte:

TRANSLATEURL_FL_GUESS_PROTOCOL

Se o esquema de protocolo não for especificado no parâmetro pcszURL para TranslateURL, o sistema escolherá automaticamente um esquema e o adicionará à URL.

TRANSLATEURL_FL_USE_DEFAULT_PROTOCOL

Se o esquema de protocolo não for especificado no parâmetro pcszURL para TranslateURL, o sistema adicionará o protocolo padrão à URL.

[out] ppszTranslatedURL

Tipo: PTSTR*

Uma variável de ponteiro que recebe o ponteiro para a cadeia de caracteres de URL recém-criada e traduzida, se houver. O parâmetro ppszTranslatedURL só será válido se a função retornar S_OK.

Valor retornado

Tipo: HRESULT

Retorna S_OK após o êxito ou S_FALSE se a URL não exigir tradução. Se ocorrer um erro, a função retornará um dos valores a seguir.

Código de retorno Descrição
E_FLAGS
 A combinação de sinalizadores passada em dwInFlags é inválida.
E_OUTOFMEMORY
 Não havia memória suficiente para concluir a operação.
E_POINTER
 Um dos ponteiros de entrada é inválido.

Comentários

Essa função não valida a cadeia de caracteres de URL de entrada. Um valor retornado bem-sucedido não indica que as cadeias de caracteres de URL são URLs válidas.

Observação

O cabeçalho intshcut.h define TranslateURL 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

   
Cliente mínimo com suporte Windows XP [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 intshcut.h
DLL Url.dll