Funzione TranslateURLW (intshcut.h)

Articolo
08/24/2023

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

Sintassi

INTSHCUTAPI HRESULT TranslateURLW(
        PCWSTR pcszURL,
        DWORD  dwInFlags,
  [out] PWSTR  *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 elementi:

TRANSLATEURL_FL_GUESS_PROTOCOL

Se lo schema di 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 e tradotta, se presente. Il parametro ppszTranslatedURL è valido solo se la funzione restituisce S_OK.

Valore restituito

Tipo: HRESULT

Restituisce S_OK in caso di esito positivo o S_FALSE se l'URL non richiede la traduzione. Se si verifica un errore, la funzione restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_FLAGS	La combinazione di flag passata in dwInFlags non è valida.
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.
E_POINTER	Uno dei puntatori di input non è valido.

Commenti

Questa funzione non convalida la stringa dell'URL di input. Un valore restituito con esito positivo non indica che le stringhe URL sono URL validi.

Nota

L'intestazione intshcut.h definisce TranslateURL come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	intshcut.h
DLL	Url.dll

Condividi tramite