Funzione PathFindSuffixArrayA (shlwapi.h)

Articolo
11/20/2024

Determina se un determinato nome file include un elenco di suffissi.

Sintassi

LPCSTR PathFindSuffixArrayA(
  [in] LPCSTR       pszPath,
  [in] const LPCSTR *apszSuffix,
  [in] int          iArraySize
);

Parametri

[in] pszPath

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null di lunghezza massima MAX_PATH contenente il nome del file da testare. È possibile usare un percorso completo.

[in] apszSuffix

Tipo: const LPCTSTR*

Matrice di puntatori stringa iArraySize. Ogni stringa a cui punta è con terminazione Null e contiene un suffisso. Le stringhe possono essere di lunghezza variabile.

[in] iArraySize

Tipo: int

Numero di elementi nella matrice a cui punta apszSuffix.

Valore restituito

Tipo: LPCTSTR

Restituisce un puntatore a una stringa con il suffisso corrispondente se ha esito positivo o null se pszPath non termina con uno dei suffissi specificati.

Osservazioni

Questa funzione usa un confronto con distinzione tra maiuscole e minuscole. Il suffisso deve corrispondere esattamente.

Nota

L'intestazione shlwapi.h definisce PathFindSuffixArray 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