Função PathCchSkipRoot (pathcch.h)

Artigo
08/25/2023

Recupera um ponteiro para o primeiro caractere em um caminho seguindo a letra da unidade ou os elementos de caminho de servidor/compartilhamento UNC (Convenção Universal de Nomenclatura).

Essa função difere de PathSkipRoot , pois aceita caminhos com prefixos "\", "\?" e "\?\UNC".

Sintaxe

WINPATHCCHAPI HRESULT PathCchSkipRoot(
  [in]  PCWSTR pszPath,
  [out] PCWSTR *ppszRootEnd
);

Parâmetros

[in] pszPath

Um ponteiro para a cadeia de caracteres do caminho.

[out] ppszRootEnd

O endereço de um ponteiro que, quando essa função retorna com êxito, aponta para o primeiro caractere em um caminho após a letra da unidade ou os elementos de caminho de compartilhamento/servidor UNC. Se o caminho consistir apenas em uma raiz, esse valor apontará para o caractere nulo de terminação da cadeia de caracteres.

Valor retornado

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos


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

Share via