FindFirstVolumeW-Funktion (fileapi.h)
Ruft den Namen eines Volumes auf einem Computer ab. FindFirstVolume wird verwendet, um mit dem Scannen der Volumes eines Computers zu beginnen.
Syntax
HANDLE FindFirstVolumeW(
[out] LPWSTR lpszVolumeName,
[in] DWORD cchBufferLength
);
Parameter
[out] lpszVolumeName
Ein Zeiger auf einen Puffer, der eine NULL-endende Zeichenfolge empfängt, die einen Volume-GUID-Pfad für das erste gefundene Volume angibt.
[in] cchBufferLength
Die Länge des Puffers, der den Volume-GUID-Pfad in TCHARs empfangen soll.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Suchhandle, das in einem nachfolgenden Aufruf der Funktionen FindNextVolume und FindVolumeClose verwendet wird.
Wenn die Funktion keine Volumes findet, ist der Rückgabewert der INVALID_HANDLE_VALUE Fehlercode. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Die FindFirstVolume-Funktion öffnet ein Volumesuchhandle und gibt Informationen zum ersten Volume zurück, das auf einem Computer gefunden wurde. Nachdem das Suchhandle eingerichtet wurde, können Sie die FindNextVolume-Funktion verwenden, um nach anderen Volumes zu suchen. Wenn das Suchhandle nicht mehr benötigt wird, schließen Sie es mithilfe der Funktion FindVolumeClose .
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) | Nein |
| SMB 3.0 Transparent Failover (TFO) | Nein |
| SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO) | Nein |
| 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
| 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 |