Função PathCchIsRoot (pathcch.h)

  • Artigo

Determina se uma cadeia de caracteres de caminho se refere à raiz de um volume.

Essa função é diferente de PathIsRoot , pois aceita caminhos com prefixos "\", "\?" e "\?\UNC".

Sintaxe

WINPATHCCHAPI BOOL PathCchIsRoot(
  [in, optional] PCWSTR pszPath
);

Parâmetros

[in, optional] pszPath

Um ponteiro para a cadeia de caracteres do caminho.

Retornar valor

Retornará TRUE se o caminho especificado for uma raiz ou FALSE caso contrário.

Comentários

A tabela a seguir mostra o valor retornado PathCchIsRoot para vários caminhos.

Caminho PathCchIsRoot
"c:\" TRUE
"c:" FALSE
"c:\path1" FALSE
"\path1" TRUE
"path1" FALSE
"\\path1\path2" TRUE
"\\path1\path2\" FALSE
"\\path1\path2\path3" FALSE
"\\path1" TRUE
"\\path1\" FALSE
"\\" TRUE
"\\?\UNC\" TRUE
"\\?\UNC\path1\path2" TRUE
"\\?\UNC\path1\path2\" FALSE
"\\?\UNC\path1\path2\path3" FALSE
"\\?\UNC\path1" TRUE
"\\?\UNC\path1\" FALSE
"\\?\c:\" TRUE
"\\?\c:" FALSE
"\\?\c:\path1" FALSE
"\\?\Volume{guid}\" TRUE
"\\?\Volume{guid}" FALSE
"\\?\Volume{guid}\path1" FALSE
NULO FALSE
"" FALSE
 

Essa função retorna TRUE para caminhos como "", "X:" ou "\\server\share". Caminhos como ".. \path2" ou "\\server" retornam FALSE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho pathcch.h
Biblioteca Pathcch.lib