Funzione TranslateURLA (intshcut.h)

Applica traduzioni comuni a una determinata stringa URL, creando una nuova stringa URL.

Sintassi

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

Parametri

pcszURL

Tipo: PCTSTR

Indirizzo della stringa URL da tradurre.

dwInFlags

Tipo: DWORD

Flag di bit che specificano la modalità di conversione della stringa URL. Questo valore può essere una combinazione dei seguenti:

TRANSLATEURL_FL_GUESS_PROTOCOL

Se lo schema del protocollo non viene specificato nel parametro pcszURL per TranslateURL, il sistema sceglie automaticamente uno schema e lo aggiunge all'URL.

TRANSLATEURL_FL_USE_DEFAULT_PROTOCOL

Se lo schema di protocollo non viene specificato nel parametro pcszURL per TranslateURL, il sistema aggiunge il protocollo predefinito all'URL.

[out] ppszTranslatedURL

Tipo: PTSTR*

Variabile puntatore che riceve il puntatore alla stringa URL appena creata, tradotta, se presente. Il parametro ppszTranslatedURL è valido solo se la funzione restituisce S_OK.

Valore restituito

Tipo: HRESULT

Restituisce S_OK al termine dell'operazione o S_FALSE se l'URL non richiede la traduzione. Se si verifica un errore, la funzione restituisce uno dei valori seguenti.

Commenti

Questa funzione non convalida la stringa URL di input. Un valore restituito riuscito non indica che le stringhe URL sono URL validi.

Requisiti