Start- und Dienstobjekte

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts von der Windows Storage Management-API abgelöst.]

VDS stellt Objekte zum Ausführen dienstbezogener Aktivitäten bereit. In diesem Thema werden die einzelnen Objekte beschrieben.

Dienstladeprogrammobjekt

Das Dienstladeprogrammobjekt stellt die Methoden bereit, die von Anwendungen zum Laden und Initialisieren von VDS verwendet werden. Um VDS für die Verwendung vorzubereiten, muss eine Anwendung die folgenden Vorgänge ausführen:

Ein Codebeispiel finden Sie unter Laden von VDS.

Lassen Sie immer zu, dass der Dienst vollständig initialisiert wird, bevor die Methoden aufgerufen werden, die vom Dienstobjekt verfügbar gemacht werden. Verwenden Sie die IVdsService::IsServiceReady-Methode , um den Status des Ladeprozesses zu bestimmen. Verwenden Sie die IVdsService::WaitForServiceReady-Methode , um Aufrufe von VDS-Objekten zu blockieren, bis die Initialisierung abgeschlossen ist.

In der folgenden Tabelle sind verwandte Schnittstellen, Enumerationen und Strukturen aufgeführt.

type Element
Schnittstellen, die immer von diesem Objekt verfügbar gemacht werden IVdsServiceLoader.
Zugeordnete Enumerationen Keine.
Zugeordnete Strukturen Keine.

 

Dienstobjekt

Das Dienstobjekt ist ein multifunktionales Objekt, das für alle VDS-Anwendungen zentral ist. Mit diesem Objekt kann ein Aufrufer die folgenden Vorgänge ausführen:

  • Bestimmen Sie den Status der Dienstinitialisierung.
  • Rufen Sie alle Hardware- oder Softwareanbieter ab, die bei VDS registriert sind.
  • Berichte zu nicht zugeordneten Datenträgern.
  • Gibt den Dateisystemtyp und den Laufwerkbuchstaben zurück, der Volumes auf einem Datenträger zugeordnet sind.
  • Entfernen Sie nicht verwendete Benutzermoduspfade und eingebundene Ordner aus der Registrierung, und aktualisieren Sie Datenträger.
  • Empfangen von VDS-Benachrichtigungen.
  • Starten Sie den Host neu.
  • Abrufen von Fibre Channel HBA-Ports oder iSCSI-Initiatoradaptern auf dem lokalen Computer.
  • Bereiten Sie LUNs sicher vor, die als Datenträger auf dem lokalen Computer zur Entfernung verfügbar gemacht werden.

VDS-Benachrichtigungsstrukturen übergeben Objekt-GUIDs an alle Anwendungen, die bei VDS registriert sind, um Benachrichtigungen zu empfangen. Verwenden Sie die IVdsService::GetObject-Methode , um eine Objekt-GUID in einen Objektzeiger zu konvertieren. Eine ausführlichere Beschreibung des Benachrichtigungsmodells finden Sie unter VDS-Benachrichtigungen.

In der folgenden Tabelle sind verwandte Schnittstellen, Enumerationen und Strukturen aufgeführt.

type Element
Schnittstellen, die immer von diesem Objekt verfügbar gemacht werden IVdsService, IVdsServiceHba*, IVdsServiceIscsi*, IVdsServiceUninstallDisk*.
Schnittstellen, die immer implementiert, aber nicht für Anwendungen verfügbar gemacht werden IVdsAdmin
Zugeordnete Enumerationen VDS_QUERY_PROVIDER_FLAG, VDS_OBJECT_TYPE, VDS_SERVICE_FLAG, VDS_DRIVE_LETTER_FLAG, VDS_FILE_SYSTEM_FLAG, VDS_FILE_SYSTEM_PROP_FLAG.
Zugeordnete Strukturen VDS_SERVICE_PROP, VDS_FILE_SYSTEM_PROP, VDS_FILE_SYSTEM_TYPE_PROP, VDS_DRIVE_LETTER_NOTIFICATION, VDS_FILE_SYSTEM_NOTIFICATION, VDS_MOUNT_POINT_NOTIFICATION.

 

*Windows Server 2003: Diese Schnittstellen werden erst unter Windows Server 2003 R2 unterstützt.

Initiatoradapterobjekt

Ein Initiatoradapterobjekt modelliert einen iSCSI-Initiatoradapter auf dem Hostcomputer des VDS-Diensts. Der VDS-Dienst kann nur Initiatoradapter auf dem lokalen Computer anzeigen. Die Rolle eines Initiatoradapterobjekts dient zum Verwalten von Anmeldesitzungen vom lokalen Computer zu iSCSI-Zielen.

In der folgenden Tabelle sind verwandte Schnittstellen, Enumerationen und Strukturen aufgeführt.

type Element
Schnittstellen, die immer von diesem Objekt verfügbar gemacht werden IVdsIscsiInitiatorAdapter*.
Zugeordnete Enumerationen VDS_ISCSI_LOGIN_TYPE. VDS_ISCSI_LOGIN_FLAG, VDS_ISCSI_AUTH_TYPE.
Zugeordnete Strukturen VDS_ISCSI_INITIATOR_ADAPTER_PROP.

 

*Windows Server 2003: Diese Schnittstelle wird erst unter Windows Server 2003 R2 unterstützt.

Initiatorportal-Objekt

Ein Initiatorportalobjekt modelliert ein iSCSI-Initiatorportal für einen iSCSI-Initiator. Ein Initiatorportal ist die Kombination aus einer IP-Adresse und einem Port, über die ein Hostcomputer eine Verbindung mit einem Portal in einem iSCSI-Subsystem herstellt. Die Rolle eines Initiatorportalobjekts besteht darin, als einer der Endpunkte eines MPIO-Pfads zu dienen und IPSEC-Sicherheitseinstellungen zu konfigurieren.

In der folgenden Tabelle sind die zugehörigen Schnittstellen, Enumerationen und Strukturen aufgeführt.

type Element
Schnittstellen, die immer von diesem Objekt verfügbar gemacht werden IVdsIscsiInitiatorPortal*.
Zugeordnete Enumerationen VDS_ISCSI_IPSEC_FLAG.
Zugeordnete Strukturen VDS_ISCSI_INITIATOR_PORTAL_PROP, VDS_ISCSI_IPSEC_KEY, VDS_IPADDRESS.

 

*Windows Server 2003: Diese Schnittstelle wird erst unter Windows Server 2003 R2 unterstützt.

HBA-Portobjekt

Das HBA-Portobjekt modelliert einen Fibre Channel Host Bus Adapter (HBA)-Port.

Verwenden Sie die IVdsServiceHba::QueryHbaPorts-Methode , um die HBA-Ports zu ermitteln, die VDS auf dem lokalen Computer bekannt sind.

In der folgenden Tabelle sind die zugehörigen Schnittstellen, Enumerationen und Strukturen aufgeführt.

type Element
Schnittstellen, die immer von diesem Objekt verfügbar gemacht werden IVdsHbaPort*.
Zugeordnete Enumerationen VDS_HBAPORT_TYPE, VDS_HBAPORT_STATUS, VDS_HBAPORT_SPEED_FLAG.
Zugeordnete Strukturen VDS_HBAPORT_PROP.

 

*Windows Server 2003: Diese Schnittstelle wird erst unter Windows Server 2003 R2 unterstützt.

VDS-Objektmodell

IVdsServiceLoader::LoadService

Laden von VDS

IVdsService::GetObject

VDS-Benachrichtigungen