Freigeben über

FilterVolumeFindNext-Funktion (fltuser.h)

Die FilterVolumeFindNext-Funktion setzt eine Volumesuche fort, die durch einen Aufruf von FilterVolumeFindFirst gestartet wurde.

Syntax

HRESULT FilterVolumeFindNext(
  [in]  HANDLE                          hVolumeFind,
  [in]  FILTER_VOLUME_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                          lpBuffer,
  [in]  DWORD                           dwBufferSize,
  [out] LPDWORD                         lpBytesReturned
);

Parameter

[in] hVolumeFind

Volumesuchhandle, das von einem vorherigen Aufruf von FilterVolumeFindFirst zurückgegeben wurde.

[in] dwInformationClass

Typ der angeforderten Informationen. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
FilterVolumeBasicInformation Der Puffer, auf den der lpBuffer-Parameter verweist, empfängt eine FILTER_VOLUME_BASIC_INFORMATION Struktur für das Volume.
FilterVolumeStandardInformation Der Puffer, auf den der lpBuffer-Parameter verweist, empfängt eine FILTER_VOLUME_STANDARD_INFORMATION-Struktur für das Volume. Diese Struktur ist ab Windows Vista verfügbar.

[out] lpBuffer

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die angeforderten Informationen empfängt. Der Typ der im Puffer zurückgegebenen Informationen wird durch den dwInformationClass-Parameter definiert.

[in] dwBufferSize

Größe des Puffers, auf den der lpBuffer-Parameter verweist, in Bytes. Der Aufrufer sollte diesen Parameter entsprechend der angegebenen dwInformationClass festlegen.

[out] lpBytesReturned

Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Anzahl von Bytes empfängt, die im Puffer zurückgegeben werden, auf den lpBuffer zeigt, wenn der Aufruf von FilterVolumeFindNext erfolgreich ist. Dieser Parameter ist erforderlich und darf nicht NULL sein.

Rückgabewert

FilterVolumeFindNext gibt S_OK zurück, wenn Volumeinformationen erfolgreich zurückgegeben werden. Andernfalls wird ein HRESULT-Fehlerwert zurückgegeben, z. B. einer der folgenden:

Rückgabecode Beschreibung
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
 Der Puffer, auf den lpBuffer verweist, ist nicht groß genug, um die angeforderten Informationen zu enthalten. Wenn dieser Wert zurückgegeben wird, enthält lpBytesReturned die Größe des Puffers, der für die angegebene dwInformationClass-Struktur erforderlich ist.
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)
 Für den dwInformationClass-Parameter wurde ein ungültiger Wert angegeben. Wenn beispielsweise FilterVolumeStandardInformation für ein Betriebssystem vor Windows Vista angegeben wird, gibt FilterVolumeFindNext diesen HRESULT-Wert zurück.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)
 In der Liste der Volumes, die dem Filter-Manager bekannt sind, wurden keine weiteren Volumes gefunden.

Hinweise

Nachdem das Suchhandle durch Aufrufen von FilterVolumeFindFirst eingerichtet wurde, verwenden Sie die FilterVolumeFindNext-Funktion , um nach anderen Volumes zu suchen. FilterVolumeFindNext findet ein Volume pro Aufruf.

Beachten Sie, dass bei Verwendung von FilterVolumeFindFirst und FilterVolumeFindNext zum Auflisten der Liste der Volumes, die dem Filter-Manager bekannt sind, es möglich ist, dass mindestens zwei Volumes in der Liste denselben Namen haben. Weitere Informationen finden Sie unter Grundlegendes zu Volumeaufzählungen mit doppelten Volumenamen.

Anforderungen

   
Zielplattform Universell
Header fltuser.h (include FltUser.h)
Bibliothek FltLib.lib
DLL FltLib.dll

Weitere Informationen

FILTER_VOLUME_BASIC_INFORMATION

FILTER_VOLUME_STANDARD_INFORMATION

FilterVolumeFindClose

FilterVolumeFindFirst

  • Last updated on