FindFirstVolumeW-Funktion (fileapi.h)

Ruft den Namen eines Volumes auf einem Computer ab. FindFirstVolume wird verwendet, um mit dem Scannen der Volumes eines Computers zu beginnen.

Syntax

HANDLE FindFirstVolumeW(
  [out] LPWSTR lpszVolumeName,
  [in]  DWORD  cchBufferLength
);

Parameter

[out] lpszVolumeName

Ein Zeiger auf einen Puffer, der eine NULL-endende Zeichenfolge empfängt, die einen Volume-GUID-Pfad für das erste gefundene Volume angibt.

[in] cchBufferLength

Die Länge des Puffers, der den Volume-GUID-Pfad in TCHARs empfangen soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Suchhandle, das in einem nachfolgenden Aufruf der Funktionen FindNextVolume und FindVolumeClose verwendet wird.

Wenn die Funktion keine Volumes findet, ist der Rückgabewert der INVALID_HANDLE_VALUE Fehlercode. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die FindFirstVolume-Funktion öffnet ein Volumesuchhandle und gibt Informationen zum ersten Volume zurück, das auf einem Computer gefunden wurde. Nachdem das Suchhandle eingerichtet wurde, können Sie die FindNextVolume-Funktion verwenden, um nach anderen Volumes zu suchen. Wenn das Suchhandle nicht mehr benötigt wird, schließen Sie es mithilfe der Funktion FindVolumeClose .

Sie sollten keine Korrelation zwischen der Reihenfolge der Volumes annehmen, die von diesen Funktionen zurückgegeben werden, und der Reihenfolge der Volumes, die sich auf dem Computer befinden. Gehen Sie insbesondere nicht von einer Korrelation zwischen der Reihenfolge der Datenträger und den Laufwerksbuchstaben aus, die vom BIOS (falls vorhanden) oder dem*der Datenträgeradministrator*in zugewiesen wurden.

Unter Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.

Technologie	Unterstützt
SMB 3.0-Protokoll (Server Message Block)	Nein
SMB 3.0 Transparent Failover (TFO)	Nein
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	Nein
Dateisystem mit freigegebenen Clustervolumes (CsvFS)	Ja
Robustes Dateisystem (Resilient File System, ReFS)	Ja

 

SMB unterstützt keine Volumeverwaltungsfunktionen.

Beispiele

Ein Beispiel finden Sie unter Anzeigen von Volumepfaden.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	fileapi.h (Einschließen von Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

FindNextVolume

FindVolumeClose

Eingebundene Ordner

Volumeverwaltungsfunktionen