IVdsService::QueryProviders-Methode (vds.h)

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Gibt ein Enumerationsobjekt zurück, das eine Liste der für VDS bekannten Hardware- und Softwareanbieter enthält.

Syntax

HRESULT QueryProviders(
  [in]  DWORD          masks,
  [out] IEnumVdsObject **ppEnum
);

Parameter

[in] masks

Die von VDS_QUERY_PROVIDER_FLAG aufgelistete Anbietermaske. Anrufer können eine Softwareanbietermaske, eine Hardwareanbietermaske oder beides angeben.

[out] ppEnum

Die Adresse eines IEnumVdsObject-Schnittstellenzeigers , der verwendet werden kann, um die Anbieter als Anbieterobjekte aufzulisten. Weitere Informationen finden Sie unter Arbeiten mit Enumerationsobjekten. Aufrufer müssen die Schnittstelle und die einzelnen Anbieterobjekte freigeben, wenn sie nicht mehr benötigt werden, indem sie die IUnknown::Release-Methode aufrufen.

Rückgabewert

Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32-Makros zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.

Rückgabecode/-wert	BESCHREIBUNG
S_OK	Die Enumeration wird erfolgreich zurückgegeben.
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS konnte nicht initialisiert werden. Wenn eine Anwendung diese Methode aufruft, bevor der Dienst die Initialisierung abgeschlossen hat, wird die Methode blockiert, bis die Initialisierung abgeschlossen ist. Wenn bei der Initialisierung ein Fehler auftritt, wird dieser Fehler zurückgegeben.

Hinweise

Um den Anbietertyp für Hardwareanbieter zu bestimmen, rufen Sie die IVdsHwProviderType2::GetProviderType2-Methode oder die IVdsHwProviderType::GetProviderType-Methode für jedes Anbieterobjekt auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vds.h
Bibliothek	Uuid.lib

Weitere Informationen

IEnumVdsObject

IVdsService

VDS_HWPROVIDER_TYPE

VDS_QUERY_PROVIDER_FLAG