Partager via


Fonction PathIsSystemFolderW (shlwapi.h)

Détermine si un dossier existant contient les attributs qui en font un dossier système. Cette fonction indique également si certains attributs qualifient un dossier comme un dossier système.

Syntaxe

BOOL PathIsSystemFolderW(
  [in, optional] LPCWSTR pszPath,
  [in]           DWORD   dwAttrb
);

Paramètres

[in, optional] pszPath

Type : LPCTSTR

Pointeur vers une chaîne null de longueur maximale MAX_PATH qui contient le nom d’un dossier existant. Les attributs de ce dossier seront récupérés et comparés à ceux qui définissent un dossier système. Si ce dossier contient les attributs permettant d’en faire un dossier système, la fonction retourne une valeur différente de zéro. Si cette valeur a la valeur NULL, cette fonction détermine si les attributs passés dans dwAttrb la qualifient de dossier système.

[in] dwAttrb

Type : DWORD

Attributs de fichier à comparer. Utilisé uniquement si pszPath a la valeur 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 en faire un dossier système, cette fonction retourne une valeur différente de zéro. Ces attributs sont les attributs retournés par GetFileAttributes.

Valeur retournée

Type : BOOL

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

Remarques

Notes

L’en-tête shlwapi.h définit PathIsSystemFolder comme un 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlwapi.h
Bibliothèque Shlwapi.lib
DLL Shlwapi.dll (version 4.71 ou ultérieure)