Start- und Dienstobjekte
[Ab Windows 8 und Windows Server 2012 wird die Virtual Disk Service COM-Schnittstelle von der Windows Storage Management APIersetzt.]
VDS stellt Objekte für die Durchführung dienstbezogener Aktivitäten bereit. In diesem Thema werden die einzelnen Objekte beschrieben.
Service Loader-Objekt
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 Loading 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 Ladevorgangs 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.
| Art | Element |
|---|---|
| Schnittstellen, die von diesem Objekt immer verfügbar gemacht werden | IVdsServiceLoader. |
| Zugeordnete Enumerationen | Nichts. |
| Zugeordnete Strukturen | Nichts. |
Service-Objekt
Das Serviceobjekt 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.
- Melden Sie sich auf nicht zugewiesenen Datenträgern.
- Geben Sie den Dateisystemtyp und den Laufwerkbuchstaben zurück, der Volumes auf einem Datenträger zugeordnet ist.
- Entfernen Sie nicht verwendete Benutzermoduspfade und bereitgestellte 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 zum Entfernen 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.
| Art | Element |
|---|---|
| Schnittstellen, die von diesem Objekt immer 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.
Initiator Adapter-Objekt
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.
| Art | Element |
|---|---|
| Schnittstellen, die von diesem Objekt immer 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.
Initiator Portal-Objekt
Ein Initiatorportalobjekt modelliert ein iSCSI-Initiatorportal auf einem iSCSI-Initiator. Ein Initiatorportal ist die Kombination einer IP-Adresse und eines Ports, über die ein Hostcomputer eine Verbindung mit einem Portal in einem iSCSI-Subsystem herstellt. Die Rolle eines Initiatorportalobjekts besteht darin, als einen 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.
| Art | Element |
|---|---|
| Schnittstellen, die von diesem Objekt immer 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-Hostbusadapter (HBA)-Port.
Verwenden Sie die IVdsServiceHba::QueryHbaPorts Methode, um die HBA-Ports zu bestimmen, die VDS auf dem lokalen Computer bekannt sind.
In der folgenden Tabelle sind die zugehörigen Schnittstellen, Enumerationen und Strukturen aufgeführt.
| Art | Element |
|---|---|
| Schnittstellen, die von diesem Objekt immer 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.
Verwandte Themen