Start- och tjänstobjekt
[Från och med Windows 8 och Windows Server 2012 ersätts com-gränssnittet virtual disk service COM med Windows Storage Management API.]
VDS tillhandahåller objekt för att utföra tjänstrelaterade aktiviteter. I det här avsnittet beskrivs varje objekt.
Service Loader-objekt
Service Loader-objektet innehåller de metoder som används av program för att läsa in och initiera VDS. För att förbereda VDS för användning måste ett program utföra följande åtgärder:
- Skapa en instans av tjänstinläsningsobjektet som returnerar IVdsServiceLoader--gränssnittet.
- Anropa metoden IVdsServiceLoader::LoadService för att läsa in tjänsten.
Ett kodexempel finns i Läsa in VDS-.
Tillåt alltid att tjänsten initieras helt innan du anropar de metoder som exponeras av tjänstobjektet. Använd metoden IVdsService::IsServiceReady för att fastställa status för inläsningsprocessen. Använd metoden IVdsService::WaitForServiceReady för att blockera anrop till VDS-objekt tills initieringen har slutförts.
I följande tabell visas relaterade gränssnitt, uppräkningar och strukturer.
| Typ | Element |
|---|---|
| Gränssnitt som alltid exponeras av det här objektet | IVdsServiceLoader. |
| Associerade uppräkningar | Ingen. |
| Associerade strukturer | Ingen. |
Tjänstobjekt
Tjänstobjektet är ett multifunktionellt objekt som är centralt för alla VDS-program. Med det här objektet kan en anropare utföra följande åtgärder:
- Fastställa status för tjänstens initiering.
- Hämta alla maskinvaru- eller programvaruleverantörer som registrerats med VDS.
- Rapportera om oallokerade diskar.
- Returnera filsystemtypen och enhetsbeteckningen som är associerad med volymer på en disk.
- Ta bort oanvända sökvägar och monterade mappar från registret och uppdatera diskar.
- Ta emot VDS-meddelanden.
- Starta om värden.
- Hämta Fibre Channel HBA-portar eller iSCSI-initierarkort på den lokala datorn.
- Förbered LUN på ett säkert sätt som exponeras som diskar på den lokala datorn för borttagning.
VDS-meddelandestrukturer skickar objekt-GUID:er till alla program som är registrerade med VDS för att ta emot meddelanden. Använd metoden IVdsService::GetObject för att konvertera ett objekt-GUID till en objektpekare. En mer fullständig beskrivning av meddelandemodellen finns i VDS-meddelanden.
I följande tabell visas relaterade gränssnitt, uppräkningar och strukturer.
| Typ | Element |
|---|---|
| Gränssnitt som alltid exponeras av det här objektet | IVdsService, IVdsServiceHba*, IVdsServiceIscsi*, IVdsServiceUninstallDisk*. |
| Gränssnitt som alltid implementeras men inte exponeras för program | IVdsAdmin |
| Associerade uppräkningar | VDS_QUERY_PROVIDER_FLAG, VDS_OBJECT_TYPE, VDS_SERVICE_FLAG, VDS_DRIVE_LETTER_FLAG, VDS_FILE_SYSTEM_FLAG, VDS_FILE_SYSTEM_PROP_FLAG. |
| Associerade strukturer | 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: Dessa gränssnitt stöds inte förrän Windows Server 2003 R2.
Initierarkortobjekt
Ett initierarkortobjekt modellerar ett iSCSI-initierarkort på värddatorn för VDS-tjänsten. VDS-tjänsten kan bara visa initierarkort på den lokala datorn. Rollen för ett initierarkortobjekt är för att hantera inloggningssessioner från den lokala datorn till iSCSI-mål.
I följande tabell visas relaterade gränssnitt, uppräkningar och strukturer.
| Typ | Element |
|---|---|
| Gränssnitt som alltid exponeras av det här objektet | IVdsIscsiInitiatorAdapter*. |
| Associerade uppräkningar | VDS_ISCSI_LOGIN_TYPE. VDS_ISCSI_LOGIN_FLAG, VDS_ISCSI_AUTH_TYPE. |
| Associerade strukturer | VDS_ISCSI_INITIATOR_ADAPTER_PROP. |
*Windows Server 2003: Det här gränssnittet stöds inte förrän Windows Server 2003 R2.
Initierarportalobjekt
Ett initierarportalobjekt modellerar en iSCSI-initierarportal på en iSCSI-initierare. En initierarportal är kombinationen av en IP-adress och port genom vilken en värddator ansluter till en portal i ett iSCSI-undersystem. Rollen för ett initierarportalobjekt är att fungera som en av slutpunkterna för en MPIO-sökväg och att konfigurera IPSEC-säkerhetsinställningar.
I följande tabell visas relaterade gränssnitt, uppräkningar och strukturer.
| Typ | Element |
|---|---|
| Gränssnitt som alltid exponeras av det här objektet | IVdsIscsiInitiatorPortal*. |
| Associerade uppräkningar | VDS_ISCSI_IPSEC_FLAG. |
| Associerade strukturer | VDS_ISCSI_INITIATOR_PORTAL_PROP, VDS_ISCSI_IPSEC_KEY, VDS_IPADDRESS. |
*Windows Server 2003: Det här gränssnittet stöds inte förrän Windows Server 2003 R2.
HBA-portobjekt
HBA-portobjektet modellerar en Fibre Channel-värdbusskortport (HBA).
Använd metoden IVdsServiceHba::QueryHbaPorts för att fastställa de HBA-portar som är kända för VDS på den lokala datorn.
I följande tabell visas relaterade gränssnitt, uppräkningar och strukturer.
| Typ | Element |
|---|---|
| Gränssnitt som alltid exponeras av det här objektet | IVdsHbaPort*. |
| Associerade uppräkningar | VDS_HBAPORT_TYPE, VDS_HBAPORT_STATUS, VDS_HBAPORT_SPEED_FLAG. |
| Associerade strukturer | VDS_HBAPORT_PROP. |
*Windows Server 2003: Det här gränssnittet stöds inte förrän Windows Server 2003 R2.
Relaterade ämnen