Funzione UrlCreateFromPathA (shlwapi.h)

Articolo
03/02/2024

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

Sintassi

LWSTDAPI UrlCreateFromPathA(
  [in]      PCSTR pszPath,
  [out]     PSTR  pszUrl,
  [in, out] DWORD *pcchUrl,
            DWORD dwFlags
);

Parametri

[in] pszPath

Tipo: PCTSTR

Stringa con terminazione Null di lunghezza massima INTERNET_MAX_URL_LENGTH contenente 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 se non ha esito positivo o un valore di errore COM standard.

Commenti

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

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 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

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	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 5.0 o successiva)

Condividi tramite