FindVolumeClose-Funktion (fileapi.h)

  • Artikel

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

Siehe auch

FindFirstVolume

FindNextVolume

Eingebundene Ordner

Volumeverwaltungsfunktionen