Função PathIsSystemFolderW (shlwapi.h)

Artigo
11/20/2024

Determina se uma pasta existente contém os atributos que a tornam uma pasta do sistema. Como alternativa, essa função indica se determinados atributos qualificam uma pasta para ser uma pasta do sistema.

Sintaxe

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

Parâmetros

[in, optional] pszPath

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo de comprimento máximo MAX_PATH que contém o nome de uma pasta existente. Os atributos dessa pasta serão recuperados e comparados com aqueles que definem uma pasta do sistema. Se essa pasta contiver os atributos para torná-la uma pasta do sistema, a função retornará diferente de zero. Se esse valor for NULL, essa função determinará se os atributos passados em dwAttrb qualificá-lo para ser uma pasta do sistema.

[in] dwAttrb

Tipo: DWORD

Os atributos de arquivo a serem comparados. Usado somente se pszPath for NULL. Nesse caso, os atributos passados nesse valor são comparados com aqueles que qualificam uma pasta como uma pasta do sistema. Se os atributos forem suficientes para tornar isso uma pasta do sistema, essa função retornará diferente de zero. Esses atributos são os atributos retornados de GetFileAttributes.

Valor de retorno

Tipo: BOOL

Retorna diferente de zero se o pszPath ou dwAttrb representar uma pasta do sistema ou zero de outra forma.

Observações

Nota

O cabeçalho shlwapi.h define PathIsSystemFolder como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	shlwapi.h
biblioteca	Shlwapi.lib
de DLL	Shlwapi.dll (versão 4.71 ou posterior)

Compartilhar via