Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die FilterVolumeFindFirst-Funktion gibt Informationen zu einem Volume zurück.
Syntax
HRESULT FilterVolumeFindFirst(
[in] FILTER_VOLUME_INFORMATION_CLASS dwInformationClass,
[out] LPVOID lpBuffer,
[in] DWORD dwBufferSize,
[out] LPDWORD lpBytesReturned,
[out] PHANDLE lpVolumeFind
);
Parameter
[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 verweist, wenn der Aufruf von FilterVolumeFindFirst erfolgreich ist. Dieser Parameter ist erforderlich und darf nicht NULL sein.
[out] lpVolumeFind
Zeiger auf eine vom Aufrufer zugewiesene Variable, die ein Suchhandle für den Minifilter empfängt, wenn der Aufruf von FilterVolumeFindFirst erfolgreich ist; andernfalls empfängt sie INVALID_HANDLE_VALUE. Dieses Suchhandle kann in nachfolgenden Aufrufen von FilterVolumeFindNext und FilterVolumeFindClose verwendet werden.
Rückgabewert
FilterVolumeFindFirst gibt S_OK zurück, wenn informationen zu einem Volume erfolgreich zurückgegeben werden. Andernfalls wird ein HRESULT-Fehlerwert zurückgegeben, z. B. einer der folgenden:
| Rückgabecode | Beschreibung |
|---|---|
|
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. |
|
Für den dwInformationClass-Parameter wurde ein ungültiger Wert angegeben. Wenn beispielsweise FilterVolumeStandardInformation für ein Betriebssystem vor Windows Vista angegeben wird, gibt FilterVolumeFindFirst diesen HRESULT-Wert zurück. |
|
In der Liste der Volumes, die dem Filter-Manager bekannt sind, wurde kein Volume gefunden. |
Hinweise
Diese FilterVolumeFindFirst-Funktion wird verwendet, um mit dem Scannen der Volumes zu beginnen, die dem Filter-Manager bekannt sind.
FilterVolumeFindFirst öffnet ein Suchhandle und gibt Informationen zum ersten Volume zurück, das in der Liste der Dem Filter-Manager bekannten Volumes gefunden wurde. Nachdem das Suchhandle eingerichtet wurde, verwenden Sie die FilterVolumeFindNext-Funktion , um nach anderen Volumes in der Liste des Filter-Managers zu suchen. Wenn das Suchhandle nicht mehr erforderlich ist, schließen Sie es, indem Sie FilterVolumeFindClose aufrufen.
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