PathCchSkipRoot-Funktion (pathcch.h)

  • Artikel

Ruft einen Zeiger auf das erste Zeichen in einem Pfad ab, der dem Laufwerkbuchstaben oder dem Server-/Freigabepfadelement der Universal Naming Convention (UNC) folgt.

Diese Funktion unterscheidet sich von PathSkipRoot dadurch, dass sie Pfade mit den Präfixen "\", "\?" und "\?\UNC" akzeptiert.

Syntax

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

Parameter

[in] pszPath

Ein Zeiger auf die Pfadzeichenfolge.

[out] ppszRootEnd

Die Adresse eines Zeigers, der bei erfolgreicher Rückgabe dieser Funktion auf das erste Zeichen in einem Pfad zeigt, der dem Laufwerkbuchstaben oder den UNC-Server-/Freigabepfadelementen folgt. Wenn der Pfad nur aus einem Stamm besteht, zeigt dieser Wert auf das endende NULL-Zeichen der Zeichenfolge.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile pathcch.h
Bibliothek Pathcch.lib