PathBuildRootW-Funktion (shlwapi.h)

Artikel
08/26/2023

Erstellt einen Stammpfad aus einer angegebenen Laufwerksnummer.

Syntax

LPWSTR PathBuildRootW(
  [out] LPWSTR pszRoot,
  [in]  int    iDrive
);

Parameter

[out] pszRoot

Typ: LPTSTR

Ein Zeiger auf die Zeichenfolge, die den erstellten Stammpfad empfängt. Dieser Puffer muss mindestens vier Zeichen lang sein.

[in] iDrive

Typ: int

Eine Variable vom Typ int , die die gewünschte Laufwerksnummer angibt. Es sollte zwischen 0 und 25 sein.

Rückgabewert

Typ: LPTSTR

Gibt die Adresse des erstellten Stammpfads zurück. Wenn der Aufruf aus irgendeinem Grund fehlschlägt (z. B. eine ungültige Laufwerksnummer), wird szRoot unverändert zurückgegeben.

Hinweise

Hinweis

Der shlwapi.h-Header definiert PathBuildRoot als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
Bibliothek	Shlwapi.lib
DLL	Shlwapi.dll (Version 4.71 oder höher)

Freigeben über