Leggere in inglese

Condividi tramite


Funzione PathResolve (shlobj_core.h)

[PathResolve è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

Converte un nome di percorso relativo o non qualificato in un nome di percorso completo.

Sintassi

int PathResolve(
  [in, out]      PWSTR    pszPath,
  [in, optional] PZPCWSTR dirs,
                 UINT     fFlags
);

Parametri

[in, out] pszPath

Tipo: PWSTR

Stringa Unicode con terminazione Null che contiene il percorso da risolvere. Quando la funzione viene restituita, la stringa contiene il percorso completo corrispondente. Questo buffer deve contenere almeno MAX_PATH caratteri.

[in, optional] dirs

Tipo: PZPCWSTR

Puntatore a una matrice facoltativa di directory con terminazione Null da cercare prima nel caso in cui il percorso non possa essere risolto da pszPath. Questo valore può essere NULL.

fFlags

Tipo: UINT

Flag che specificano il funzionamento della funzione.

PRF_VERIFYEXISTS

Restituisce TRUE se l'esistenza del file è verificata; in caso contrario FALSE.

PRF_TRYPROGRAMEXTENSIONS

Cercare il percorso specificato con le estensioni seguenti aggiunte: .pif, .com, .bat, .cmd, .lnk e .exe.

PRF_FIRSTDIRDEF

Cercare prima nella directory o nelle directory specificate da dirs.

PRF_DONTFINDLNK

Ignorare .lnk file.

PRF_REQUIREABSOLUTE

Richiedere un percorso assoluto (completo).

Valore restituito

Tipo: int

Restituisce TRUE, a meno che non sia impostato PRF_VERIFYEXISTS. Se tale flag è impostato, la funzione restituisce TRUE se il file è verificato che esista e FALSE in caso contrario. Imposta anche un codice di errore ERROR_FILE_NOT_FOUND che è possibile recuperare chiamando GetLastError.

Commenti

Un valore restituito FALSE non significa necessariamente che il file non esista. Potrebbe significare che la funzione non è semplicemente in grado di trovare il file dalle informazioni fornite.

Se PathResolve non riesce a risolvere il percorso specificato in pszPath, chiama PathFindOnPath usando pszPath e dirs come parametri.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlobj_core.h (includere Shlobj.h)
Libreria Shell32.lib
DLL Shell32.dll (versione 5.0 o successiva)
Set di API ext-ms-win-shell-shell32-l1-2-2 (introdotto in Windows 10, versione 10.0.14393)

Vedi anche

PathFindOnPath