GetVolumesFromDriveW-Funktion (ntmsapi.h)
[Wechselmedien-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr verfügbar.]
Die GetVolumesFromDrive--Funktion ruft das Volume und den Laufwerkbuchstaben für ein bestimmtes Wechselmedienlaufwerk ab.
Syntax
DWORD GetVolumesFromDriveW(
[in] LPWSTR pszDriveName,
[out] LPWSTR *VolumeNameBufferPtr,
[out] LPWSTR *DriveLetterBufferPtr
);
Parameter
[in] pszDriveName
Der Name des Wechselmedienlaufwerks.
[out] VolumeNameBufferPtr
Das Volume, das das Wechselmedienlaufwerk darstellt.
[out] DriveLetterBufferPtr
Der Laufwerkbuchstaben, der das Wechselmedienlaufwerk darstellt.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der Systemfehlercodes.
Bemerkungen
Bei dieser Funktion wird davon ausgegangen, dass nur null oder eine Partition auf einem Wechseldatenträger vorhanden ist, sodass es höchstens einen Laufwerkbuchstaben und einen Volumenamen gibt.
Anmerkung
Der ntmsapi.h-Header definiert GetVolumesFromDrive als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | ntmsapi.h |
| Library | Ntmsapi.lib |
| DLL- | Ntmsapi.dll |