FindVolumeClose-Funktion (fileapi.h)
Schließt das angegebene Volume-Suchhandle. Die Funktionen FindFirstVolume und FindNextVolume verwenden dieses Suchhandle, um Volumes zu suchen.
Syntax
BOOL FindVolumeClose(
[in] HANDLE hFindVolume
);
Parameter
[in] hFindVolume
Das zu schließende Volumesuchhandle. Dieses Handle muss zuvor von der FindFirstVolume-Funktion geöffnet worden sein.
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.
Hinweise
Nachdem die FindVolumeClose-Funktion aufgerufen wurde, kann das Handle hFindVolume nicht in nachfolgenden Aufrufen von FindNextVolume oder FindVolumeClose verwendet werden.
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 | fileapi.h (Einschließen von Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |