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 |