IVdsServiceLoader::LoadService-Methode (vds.h)
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API abgelöst.]
Startet VDS auf dem angegebenen Computer und gibt einen Zeiger auf das Dienstobjekt zurück.
Syntax
HRESULT LoadService(
[in] LPWSTR pwszMachineName,
[out] IVdsService **ppService
);
Parameter
[in] pwszMachineName
Dieser Parameter muss auf NULL festgelegt werden.
Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista und Windows Server 2003: Dieser Parameter enthält den Namen des Hostcomputers. Wenn sie auf NULL festgelegt wird, wird VDS auf dem lokalen Host geladen und initialisiert.
[out] ppService
Die Adresse eines IVdsService-Schnittstellenzeigers . Aufrufer müssen die Schnittstelle freigeben, wenn sie nicht mehr benötigt wird, 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 makros HRESULT_FROM_WIN32 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 | BESCHREIBUNG |
|---|---|
|
Der Dienst wurde erfolgreich gestartet. |
Hinweise
Obwohl S_OK angibt, dass VDS erfolgreich gestartet wurde, kann die Dienstinitialisierung unvollständig sein, wenn die Methode zurückgegeben wird. Aus diesem Grund müssen Sie nach dem Aufrufen dieser Methode die IVdsService::WaitForServiceReady-Methode aufrufen, um auf den Abschluss der VDS-Initialisierung zu warten.
Ein Codebeispiel finden Sie unter Laden von VDS.
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 |