Função PathIsSameRootW (shlwapi.h)

Artigo
11/20/2024

Compara dois caminhos para determinar se eles têm um componente raiz comum.

Sintaxe

BOOL PathIsSameRootW(
  [in] LPCWSTR pszPath1,
  [in] LPCWSTR pszPath2
);

Parâmetros

[in] pszPath1

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo de comprimento máximo MAX_PATH que contém o primeiro caminho a ser comparado.

[in] pszPath2

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo de comprimento máximo MAX_PATH que contém o segundo caminho a ser comparado.

Valor de retorno

Tipo: BOOL

Retorna VERDADEIRO se ambas as cadeias de caracteres tiverem o mesmo componente raiz ou FALSE caso contrário. Se pszPath1 contiver apenas o servidor e o compartilhamento, essa função também retornará FALSE.

Observações

Nota

O cabeçalho shlwapi.h define PathIsSameRoot 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