FindNextVolumeA-Funktion (winbase.h)
Setzt eine Volumesuche fort, die von einem Aufruf der FindFirstVolume-Funktion gestartet wurde. FindNextVolume findet ein Volume pro Anruf.
Syntax
BOOL FindNextVolumeA(
[in] HANDLE hFindVolume,
[out] LPSTR lpszVolumeName,
[in] DWORD cchBufferLength
);
Parameter
[in] hFindVolume
Der Volumensuchvorgang, der von einem vorherigen Aufruf der FindFirstVolume-Funktion zurückgegeben wird.
[out] lpszVolumeName
Ein Zeiger auf eine Zeichenfolge, die den gefundenen Volume-GUID-Pfad empfängt.
[in] cchBufferLength
Die Länge des Puffers, der den Volume-GUID-Pfad 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. Nehmen Sie insbesondere keine Korrelation zwischen Volumenreihenfolge und Laufwerkbuchstaben an, die dem BIOS (sofern vorhanden) oder dem Datenträgeradministrator zugewiesen wurden.
In Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.
| Technologie | Unterstützt |
|---|---|
| Server message Block (SMB) 3.0-Protokoll | No |
| SMB 3.0 Transparent Failover (TFO) | No |
| SMB 3.0 mit Skalierungsdateifreigaben (SO) | No |
| Cluster Shared Volume File System (CsvFS) | Yes |
| Robustes Dateisystem (Resilient File System, ReFS) | Yes |
SMB unterstützt keine Volumenverwaltungsfunktionen.
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 | winbase.h (schließen Sie Windows.h ein) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |