GetVolumesFromDriveA-Funktion (ntmsapi.h)

  • Artikel

[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 GetVolumesFromDriveA(
  [in]  LPSTR pszDriveName,
  [out] LPSTR *VolumeNameBufferPtr,
  [out] LPSTR *DriveLetterBufferPtr
);

Parameter

[in] pszDriveName

Der Name des Wechselmedienlaufwerks.

[out] VolumeNameBufferPtr

Das Volume, das das Wechselmedienlaufwerk darstellt.

[out] DriveLetterBufferPtr

Der Laufwerkbuchstabe, 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.

Hinweise

Bei dieser Funktion wird davon ausgegangen, dass auf einem Wechseldatenträger nur 0 oder eine Partition vorhanden ist, sodass höchstens ein Laufwerkbuchstabe und ein Volumename vorhanden sind.

Hinweis

Der ntmsapi.h-Header definiert GetVolumesFromDrive 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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ntmsapi.h
Bibliothek Ntmsapi.lib
DLL Ntmsapi.dll

Weitere Informationen

GetNtmsObjectInformation

Bibliothekssteuerungsfunktionen