IVdsAdmin::RegisterProvider-Methode (vdshwprv.h)
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]
Registriert den angegebenen Hardwareanbieter bei VDS. Hardwareanbieter rufen diese Methode auf.
Syntax
HRESULT RegisterProvider(
[in] VDS_OBJECT_ID providerId,
[in] CLSID providerClsid,
[in] LPWSTR pwszName,
[in] VDS_PROVIDER_TYPE type,
[in] LPWSTR pwszMachineName,
[in] LPWSTR pwszVersion,
[in] GUID guidVersionId
);
Parameter
[in] providerId
Die GUID des Hardwareanbieters.
[in] providerClsid
Der COM-Klassenbezeichner (Clsid) des Hardwareanbieters.
[in] pwszName
Der Name des Hardwareanbieters als null beendete, lesbare Zeichenfolge.
[in] type
Die von VDS_PROVIDER_TYPE aufgelisteten Anbietertypen. Verwenden Sie den wert VDS_PT_HARDWARE , um einen Hardwareanbieter bei VDS zu registrieren.
[in] pwszMachineName
Der Name des Computers, auf dem der Hardwareanbieter ausgeführt wird; eine null-beendete, für Menschen lesbare Zeichenfolge. Verwenden Sie NULL , um auf den aktuellen Computer zu verweisen.
[in] pwszVersion
Die Version des Anbieters als null beendete, für Menschen lesbare Zeichenfolge.
[in] guidVersionId
Die GUID für diese Version des Anbieters.
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 providerId ist bereits registriert. Nur eine Version eines Anbieters kann jederzeit registriert werden. |
Hinweise
Rufen Sie ggf . UnregisterProvider auf, um einen Anbieter zu entfernen, bevor Sie eine neue Version registrieren.
Ein prozessinterner Anbieter ruft diese Methode von DllRegisterServer auf. während ein Out-of-Process-Anbieter von der WinMain-Funktion aufruft.
Hardwareanbieter dürfen die Ausführung nicht beenden, während VDS ausgeführt wird.
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 | vdshwprv.h |
Bibliothek | Uuid.lib |