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:
- Erstellen Sie eine Instanz des Dienstladeprogrammobjekts, das die IVdsServiceLoader-Schnittstelle zurückgibt.
- Rufen Sie die IVdsServiceLoader::LoadService-Methode auf, um den Dienst zu laden.
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.
Zugehörige Themen