Opstart- en serviceobjecten
[Vanaf Windows 8 en Windows Server 2012 wordt de Virtual Disk Service COM-interface vervangen door de Windows Storage Management API.]
VDS biedt objecten voor het uitvoeren van servicegerelateerde activiteiten. In dit onderwerp wordt elk object beschreven.
Serviceloader-object
Het servicelaadprogrammaobject biedt de methoden die door toepassingen worden gebruikt om VDS te laden en te initialiseren. Als u VDS wilt voorbereiden voor gebruik, moet een toepassing de volgende bewerkingen uitvoeren:
- Maak een exemplaar van het servicelaadprogrammaobject, dat de IVdsServiceLoader interface retourneert.
- Roep de methode IVdsServiceLoader::LoadService aan om de service te laden.
Zie VDS-laden voor een codevoorbeeld.
Sta de service altijd toe om volledig te initialiseren voordat u de methoden aanroept die door het serviceobject worden weergegeven. Gebruik de methode IVdsService::IsServiceReady om de status van het laadproces te bepalen. Gebruik de methode IVdsService::WaitForServiceReady om aanroepen naar VDS-objecten te blokkeren totdat de initialisatie is voltooid.
De volgende tabel bevat gerelateerde interfaces, opsommingen en structuren.
| Type | Element |
|---|---|
| Interfaces die altijd worden weergegeven door dit object | IVdsServiceLoader. |
| Gekoppelde opsommingen | Geen. |
| Gekoppelde structuren | Geen. |
Serviceobject
Het serviceobject is een multifunctioneel object dat centraal staat bij alle VDS-toepassingen. Met dit object kan een aanroeper de volgende bewerkingen uitvoeren:
- Bepaal de status van de service-initialisatie.
- Haal alle hardware- of softwareproviders op die zijn geregistreerd bij VDS.
- Rapport over niet-toegewezen schijven.
- Retourneer het bestandssysteemtype en de stationsletter die aan volumes op een schijf zijn gekoppeld.
- Verwijder ongebruikte gebruikersmoduspaden en gekoppelde mappen uit het register en vernieuw schijven.
- VDS-meldingen ontvangen.
- Start de host opnieuw op.
- Fibre Channel HBA-poorten of iSCSI-initiatoradapters ophalen op de lokale computer.
- Bereid LUN's veilig voor als schijven op de lokale computer voor verwijdering.
VDS-meldingsstructuren geven object-GUID's door aan alle toepassingen die zijn geregistreerd bij VDS om meldingen te ontvangen. Gebruik de methode IVdsService::GetObject om een object-GUID te converteren naar een objectaanwijzer. Zie VDS-meldingenvoor een volledige beschrijving van het meldingsmodel.
De volgende tabel bevat gerelateerde interfaces, opsommingen en structuren.
| Type | Element |
|---|---|
| Interfaces die altijd worden weergegeven door dit object | IVdsService, IVdsServiceHba*, IVdsServiceIscsi*, IVdsServiceUninstallDisk*. |
| Interfaces die altijd worden geïmplementeerd, maar niet beschikbaar zijn voor toepassingen | IVdsAdmin- |
| Gekoppelde opsommingen | VDS_QUERY_PROVIDER_FLAG, VDS_OBJECT_TYPE, VDS_SERVICE_FLAG, VDS_DRIVE_LETTER_FLAG, VDS_FILE_SYSTEM_FLAG, VDS_FILE_SYSTEM_PROP_FLAG. |
| Gekoppelde structuren | 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: Deze interfaces worden pas ondersteund als Windows Server 2003 R2.
Initiator adapterobject
Een initiatoradapterobject modelleert een iSCSI-initiatoradapter op de hostcomputer van de VDS-service. De VDS-service kan alleen initiatoradapters op de lokale computer weergeven. De rol van een initiatoradapterobject is voor het beheren van aanmeldingssessies van de lokale computer naar iSCSI-doelen.
De volgende tabel bevat gerelateerde interfaces, opsommingen en structuren.
| Type | Element |
|---|---|
| Interfaces die altijd worden weergegeven door dit object | IVdsIscsiInitiatorAdapter*. |
| Gekoppelde opsommingen | VDS_ISCSI_LOGIN_TYPE. VDS_ISCSI_LOGIN_FLAG, VDS_ISCSI_AUTH_TYPE. |
| Gekoppelde structuren | VDS_ISCSI_INITIATOR_ADAPTER_PROP. |
*Windows Server 2003: Deze interface wordt pas ondersteund als Windows Server 2003 R2.
Portalobject initiator
Een initiatorportalobject modelll een iSCSI-initiatorportal op een iSCSI-initiator. Een initiatorportal is de combinatie van een IP-adres en poort waarmee een hostcomputer verbinding maakt met een portal op een iSCSI-subsysteem. De rol van een initiatorportalobject is om te fungeren als een van de eindpunten van een MPIO-pad en om IPSEC-beveiligingsinstellingen te configureren.
De volgende tabel bevat de gerelateerde interfaces, opsommingen en structuren.
| Type | Element |
|---|---|
| Interfaces die altijd worden weergegeven door dit object | IVdsIscsiInitiatorPortal*. |
| Gekoppelde opsommingen | VDS_ISCSI_IPSEC_FLAG. |
| Gekoppelde structuren | VDS_ISCSI_INITIATOR_PORTAL_PROP, VDS_ISCSI_IPSEC_KEY, VDS_IPADDRESS. |
*Windows Server 2003: Deze interface wordt pas ondersteund als Windows Server 2003 R2.
HBA-poortobject
Het HBA-poortobject modelleren een HBA-poort (Fibre Channel Host Bus Adapter).
Gebruik de methode IVdsServiceHba::QueryHbaPorts om de HBA-poorten te bepalen die bekend zijn bij VDS op de lokale computer.
De volgende tabel bevat de gerelateerde interfaces, opsommingen en structuren.
| Type | Element |
|---|---|
| Interfaces die altijd worden weergegeven door dit object | IVdsHbaPort*. |
| Gekoppelde opsommingen | VDS_HBAPORT_TYPE, VDS_HBAPORT_STATUS, VDS_HBAPORT_SPEED_FLAG. |
| Gekoppelde structuren | VDS_HBAPORT_PROP. |
*Windows Server 2003: Deze interface wordt pas ondersteund als Windows Server 2003 R2.
Verwante onderwerpen