Función PathIsSystemFolderA (shlwapi.h)

Determina si una carpeta existente contiene los atributos que lo convierten en una carpeta del sistema. Como alternativa, esta función indica si determinados atributos califican una carpeta para que sea una carpeta del sistema.

Sintaxis

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

Parámetros

[in, optional] pszPath

Tipo: LPCTSTR de

Puntero a una cadena terminada en null de longitud máxima MAX_PATH que contiene el nombre de una carpeta existente. Los atributos de esta carpeta se recuperarán y compararán con los que definen una carpeta del sistema. Si esta carpeta contiene los atributos para convertirlos en una carpeta del sistema, la función devuelve un valor distinto de cero. Si este valor es null, esta función determina si los atributos pasados en dwAttrb califican como una carpeta del sistema.

[in] dwAttrb

Tipo: DWORD de

Atributos de archivo que se van a comparar. Solo se usa si pszPath es NULL. En ese caso, los atributos pasados en este valor se comparan con los que califican una carpeta como carpeta del sistema. Si los atributos son suficientes para convertir esta carpeta del sistema en una carpeta del sistema, esta función devuelve un valor distinto de cero. Estos atributos son los atributos que se devuelven de GetFileAttributes.

Valor devuelto

Tipo: BOOL de

Devuelve un valor distinto de cero si el pszPath o dwAttrb representa una carpeta del sistema o cero de lo contrario.

Observaciones

Nota

El encabezado shlwapi.h define PathIsSystemFolder como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shlwapi.h
biblioteca de	Shlwapi.lib
DLL de	Shlwapi.dll (versión 4.71 o posterior)