Funzione UrlCreateFromPathW (shlwapi.h)

Articolo
11/20/2024

Converte un percorso di Microsoft MS-DOS in un URL canonico.

Sintassi

LWSTDAPI UrlCreateFromPathW(
  [in]      PCWSTR pszPath,
  [out]     PWSTR  pszUrl,
  [in, out] DWORD  *pcchUrl,
            DWORD  dwFlags
);

Parametri

[in] pszPath

Tipo: PCTSTR

Stringa con terminazione Null di lunghezza massima INTERNET_MAX_URL_LENGTH che contiene il percorso MS-DOS.

[out] pszUrl

Tipo: PTSTR

Puntatore a un buffer che, quando questa funzione viene restituita correttamente, riceve l'URL.

[in, out] pcchUrl

Tipo: DWORD*

Numero di caratteri in pszUrl.

dwFlags

Tipo: DWORD

Riservato. Impostare questo parametro su NULL.

Valore restituito

Tipo: HRESULT

Restituisce S_FALSE se pszPath è già in formato URL. In questo caso, pszPath verrà semplicemente copiato in pszUrl. In caso contrario, restituisce S_OK se ha esito positivo o un valore di errore COM standard, in caso contrario.

Osservazioni

NotaUrlCreateFromPath non supporta i percorsi estesi. Si tratta di percorsi che includono il prefisso del percorso esteso "\\?\".

Nota

L'intestazione shlwapi.h definisce UrlCreateFromPath 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 5.0 o successiva)

Condividi tramite