FindFirstVolume: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
Zeile 2: Zeile 2:
 
Die API-Funktion [[FindFirstVolume]] ermittelt den Namen (GUID) eines Volumes. Sie wird aufgerufen, um einen Computer nach Volumes zu durchsuchen.
 
Die API-Funktion [[FindFirstVolume]] ermittelt den Namen (GUID) eines Volumes. Sie wird aufgerufen, um einen Computer nach Volumes zu durchsuchen.
  
<syntaxhighlight lang="vb">
+
<syntaxhighlight lang="<syntaxhighlight lang="vb">">
  
 
Declare Function FindFirstVolume lib "kernel32.dll" _
 
Declare Function FindFirstVolume lib "kernel32.dll" _
Zeile 28: Zeile 28:
 
==Beispiel==
 
==Beispiel==
  
<syntaxhighlight lang="vb">
+
<syntaxhighlight lang="<syntaxhighlight lang="vb">">
 
'Beispielcode, zeigt die im System vorhandenen Volumes im Direktfenster an...
 
'Beispielcode, zeigt die im System vorhandenen Volumes im Direktfenster an...
 
Dim strGUID As String
 
Dim strGUID As String
Zeile 60: Zeile 60:
 
==Verwandte Funktionen==
 
==Verwandte Funktionen==
  
[http://www.activevb.de/rubriken/apikatalog/deklarationen/findnextvolume.html FindNextVolume] - nächstes Volume suchen<br>
+
[http://www.active<syntaxhighlight lang="vb">.de/rubriken/apikatalog/deklarationen/findnextvolume.html FindNextVolume] - nächstes Volume suchen<br>
[http://www.activevb.de/rubriken/apikatalog/deklarationen/findvolumeclose.html FindVolumeClose] - Suche abschließen<br>
+
[http://www.active<syntaxhighlight lang="vb">.de/rubriken/apikatalog/deklarationen/findvolumeclose.html FindVolumeClose] - Suche abschließen<br>
  
 
==Verweise==
 
==Verweise==

Version vom 5. November 2016, 23:10 Uhr

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 ein Handle des Types Long für folgende Aufrufe der Funktionen FindNextVolume und FindVolumeClose 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.

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)


Hinweise

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


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)


Verwandte Funktionen

<syntaxhighlight lang="vb">.de/rubriken/apikatalog/deklarationen/findnextvolume.html FindNextVolume - nächstes Volume suchen
<syntaxhighlight lang="vb">.de/rubriken/apikatalog/deklarationen/findvolumeclose.html FindVolumeClose - Suche abschließen

Verweise

MSDN US-Libary - FindFirstVolume