FindFirstVolume

Aus API-Wiki
Version vom 1. Januar 2010, 11:58 Uhr von RolandB (Diskussion | Beiträge) (Die Seite wurde neu angelegt: „__NOTOC__ Die API-Funktion FindFirstVolume ermittelt den Namen (GUID) eines Volumes. Sie wird aufgerufen, um einen Computer nach Volumes zu durchsuchen. <cod...“)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springenZur Suche springen

Die API-Funktion FindFirstVolume ermittelt den Namen (GUID) eines Volumes. Sie wird aufgerufen, um einen Computer nach Volumes zu durchsuchen.

Declare Function FindFirstVolume lib "kernel32.dll" _

                Alias "FindFirstVolumeA" ( _
                ByVal lpszVolumeName As String, _
                ByVal cchBufferLength As Long) As Long


Parameter

lpszVolumeName

Puffer für die Rückgabe des ersten gefundenen Volumenamens (GUID).

cchBufferLength

Länge des als Parameter 1 übergebenen Puffers.


Rückgabe

Die Funktion gibt eine Handle des Types Long für folgende Aufrufe der Funktionen FindNextVolume und FindCloseVolume zurück.

Wird kein Volume gefunden, dann liefert die Funktion INVALID_HANDLE_VALUE. In diesem Fall können weitere Informationen mit der Funktion GetLastError abgerufen werden.


[OPTIONAL] Beispiel

'Beispielcode, zeigt die im System vorhandenen Volumes im Direktfenster an... Dim strGUID As String Dim lngHandle As Long

 strGUID = String(80, 0)
 lngHandle = FindFirstVolume(strGUID, Len(strGUID))
 Debug.Print strGUID
 While (FindNextVolume(lngHandle, strGUID, Len(strGUID)))
   Debug.Print strGUID
 Wend
 FindVolumeClose (lngHandle)


[OPTIONAL] Hinweise

Der Übergabepuffer muss vor dem Aufruf der Funktion durch Füllen mit Nullen initialisiert werden.


[OPTIONAL] Betriebsystem

Die Funktion ist unter folgenden Betriebssystemen funktionsfähig:

  • Windows NT 4.0
  • Windows NT 5.0 (2000)
  • Windows XP (ab SP2)
  • Windows Vista (nur x64)


[OPTIONAL] Verwandte Funktionen

FindNextVolume - nächstes Volume suchen
FindCloseVolume - Suche abschließen


[OPTIONAL] Verweise

MSDN US-Libary - FindFirstVolume