FindNextVolumeA-Funktion (winbase.h)

Setzt eine Volumesuche fort, die durch einen Aufruf der FindFirstVolume-Funktion gestartet wurde. FindNextVolume findet ein Volume pro Aufruf.

Syntax

BOOL FindNextVolumeA(
  [in]  HANDLE hFindVolume,
  [out] LPSTR  lpszVolumeName,
  [in]  DWORD  cchBufferLength
);

Parameter

[in] hFindVolume

Das Volumesuchhandle, das von einem vorherigen Aufruf der FindFirstVolume-Funktion zurückgegeben wurde.

[out] lpszVolumeName

Ein Zeiger auf eine Zeichenfolge, die den gefundenen Volume-GUID-Pfad empfängt.

[in] cchBufferLength

Die Länge des Puffers, der den GUID-Pfad des Volumes empfängt , in TCHARs.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Wenn keine übereinstimmenden Dateien gefunden werden können, gibt die GetLastError-Funktion den ERROR_NO_MORE_FILES Fehlercode zurück. Schließen Sie in diesem Fall die Suche mit der Funktion FindVolumeClose .

Hinweise

Nachdem das Suchhandle durch Aufrufen von FindFirstVolume eingerichtet wurde, können Sie die FindNextVolume-Funktion verwenden, um nach anderen Volumes zu suchen.

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)	No
SMB 3.0 Transparent Failover (TFO)	No
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	No
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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

FindFirstVolume

FindVolumeClose

Eingebundene Ordner

Volumeverwaltungsfunktionen