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 |
|---|---|
|
Die Enumeration wird erfolgreich zurückgegeben. |
|
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 |