Funzione PathMatchSpecExW (shlwapi.h)

Articolo
11/20/2024

Trova la corrispondenza con un nome di file da un percorso rispetto a uno o più modelli di nome file.

Sintassi

LWSTDAPI PathMatchSpecExW(
  [in] LPCWSTR pszFile,
  [in] LPCWSTR pszSpec,
  [in] DWORD   dwFlags
);

Parametri

[in] pszFile

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null contenente il percorso da cui trovare la corrispondenza del nome file.

[in] pszSpec

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null che contiene il modello di nome file per il quale eseguire la ricerca. Può trattarsi del nome esatto oppure può contenere caratteri jolly. Se viene specificato esattamente un criterio, impostare il flag di PMSF_NORMAL in dwFlags. Se vengono specificati più modelli, separarli con punti e virgola e impostare il flag di PMSF_MULTIPLE.

[in] dwFlags

Tipo: DWORD

Modifica la condizione di ricerca. Di seguito sono riportati i flag validi.

PMSF_NORMAL (0x00000000)

Il parametro pszSpec punta a un singolo modello di nome file da associare.

PMSF_MULTIPLE (0x00000001)

Il parametro pszSpec punta a un elenco delimitato da punto e virgola di modelli di nomi di file da associare.

PMSF_DONT_STRIP_SPACES (0x00010000)

Se si usa PMSF_NORMAL, non ignorare gli spazi iniziali nella stringa a cui punta pszSpec. Se si usa PMSF_MULTIPLE, non ignorare gli spazi iniziali in ogni tipo di file contenuto nella stringa a cui punta pszSpec. Questo flag può essere combinato con PMSF_NORMAL e PMSF_MULTIPLE.

Valore restituito

Tipo: HRESULT

Restituisce uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Un modello di nome file specificato in pszSpec corrisponde al nome file trovato nella stringa a cui punta pszFile.
S_FALSE	Nessun modello di nome file specificato in pszSpec corrisponde al nome file trovato nella stringa a cui punta pszFile.

Osservazioni

Nota

L'intestazione shlwapi.h definisce PathMatchSpecEx 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 Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 7.0 o successiva)

Vedere anche

PathMatchSpec

Condividi tramite