Função TranslateURLA (intshcut.h)

Artigo
11/20/2024

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

Sintaxe

INTSHCUTAPI HRESULT TranslateURLA(
        PCSTR pcszURL,
        DWORD dwInFlags,
  [out] PSTR  *ppszTranslatedURL
);

Parâmetros

pcszURL

Tipo: PCTSTR

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

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 será válido somente se a função retornar S_OK.

Valor de retorno

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.

Observações

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.

Nota

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 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 XP [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	intshcut.h
de DLL	Url.dll

Compartilhar via