Funzione PathIsSystemFolderA (shlwapi.h)

Articolo
11/20/2024

Determina se una cartella esistente contiene gli attributi che lo rendono una cartella di sistema. In alternativa, questa funzione indica se determinati attributi qualificano una cartella come cartella di sistema.

Sintassi

BOOL PathIsSystemFolderA(
  [in, optional] LPCSTR pszPath,
  [in]           DWORD  dwAttrb
);

Parametri

[in, optional] pszPath

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null di lunghezza massima MAX_PATH che contiene il nome di una cartella esistente. Gli attributi per questa cartella verranno recuperati e confrontati con quelli che definiscono una cartella di sistema. Se questa cartella contiene gli attributi per renderla una cartella di sistema, la funzione restituisce un valore diverso da zero. Se questo valore è NULL, questa funzione determina se gli attributi passati in dwAttrb qualificarlo come cartella di sistema.

[in] dwAttrb

Tipo: DWORD

Attributi di file da confrontare. Utilizzato solo se pszPath è NULL. In tal caso, gli attributi passati in questo valore vengono confrontati con quelli che qualificano una cartella come cartella di sistema. Se gli attributi sono sufficienti per rendere questa cartella di sistema, questa funzione restituisce un valore diverso da zero. Questi attributi sono gli attributi restituiti da GetFileAttributes.

Valore restituito

Tipo: bool

Restituisce un valore diverso da zero se il pszPath o dwAttrb rappresenta una cartella di sistema oppure zero.

Osservazioni

Nota

L'intestazione shlwapi.h definisce PathIsSystemFolder 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 4.71 o successiva)

Condividi tramite