PathIsSystemFolderA, fonction (shlwapi.h)

Article
11/20/2024

Détermine si un dossier existant contient les attributs qui en font un dossier système. Sinon, cette fonction indique si certains attributs qualifient un dossier pour être un dossier système.

Syntaxe

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

Paramètres

[in, optional] pszPath

Type : LPCTSTR

Pointeur vers une chaîne terminée par null de longueur maximale MAX_PATH qui contient le nom d’un dossier existant. Les attributs de ce dossier sont récupérés et comparés à ceux qui définissent un dossier système. Si ce dossier contient les attributs pour le rendre un dossier système, la fonction retourne un nombre différent de zéro. Si cette valeur est NULL, cette fonction détermine si les attributs passés dans dwAttrb le qualifient comme dossier système.

[in] dwAttrb

Type : DWORD

Attributs de fichier à comparer. Utilisé uniquement si pszPath est NULL . Dans ce cas, les attributs passés dans cette valeur sont comparés à ceux qui qualifient un dossier en tant que dossier système. Si les attributs sont suffisants pour faire de ce dossier système, cette fonction retourne une valeur différente de zéro. Ces attributs sont les attributs retournés par GetFileAttributes.

Valeur de retour

Type : BOOL

Retourne une valeur différente de zéro si le pszPath ou dwAttrb représentent un dossier système ou zéro dans le cas contraire.

Remarques

Note

L’en-tête shlwapi.h définit PathIsSystemFolder comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	shlwapi.h
bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 4.71 ou ultérieure)

Partager via