Oggetti di avvio e servizio
[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.]
VDS fornisce oggetti per l'esecuzione di attività correlate al servizio. In questo argomento vengono descritti ogni oggetto .
Oggetto Loader del servizio
L'oggetto caricatore del servizio fornisce i metodi usati dalle applicazioni per caricare e inizializzare VDS. Per preparare vDS per l'uso, un'applicazione deve eseguire le operazioni seguenti:
- Creare un'istanza dell'oggetto caricatore del servizio, che restituisce l'interfaccia IVdsServiceLoader .
- Chiamare il metodo IVdsServiceLoader::LoadService per caricare il servizio.
Per un esempio di codice, vedere Caricamento di VDS.
Consentire sempre al servizio di inizializzare completamente prima di chiamare i metodi esposti dall'oggetto servizio. Usare il metodo IVdsService::IsServiceReady per determinare lo stato del processo di caricamento. Usare il metodo IVdsService::WaitForServiceReady per bloccare le chiamate agli oggetti VDS fino al completamento dell'inizializzazione.
Nella tabella seguente sono elencate le interfacce, le enumerazioni e le strutture correlate.
| Tipo | Elemento |
|---|---|
| Interfacce sempre esposte da questo oggetto | IVdsServiceLoader. |
| Enumerazioni associate | Nessuno. |
| Strutture associate | Nessuno. |
Oggetto Service
L'oggetto servizio è un oggetto multifunzione centrale per tutte le applicazioni VDS. Con questo oggetto, un chiamante può eseguire le operazioni seguenti:
- Determinare lo stato dell'inizializzazione del servizio.
- Recuperare tutti i provider hardware o software registrati con VDS.
- Report su dischi non allocati.
- Restituisce il tipo di file system e la lettera di unità associati ai volumi in un disco.
- Rimuovere i percorsi in modalità utente inutilizzati e le cartelle montate dal Registro di sistema e aggiornare i dischi.
- Ricevere notifiche VDS.
- Riavviare l'host.
- Recuperare le porte HBA Fibre Channel o le schede iniziatore iSCSI nel computer locale.
- Preparare in modo sicuro i LUN esposti come dischi nel computer locale per la rimozione.
Le strutture di notifica VDS passano i GUID oggetto a tutte le applicazioni registrate con VDS per ricevere notifiche. Utilizzare il metodo IVdsService::GetObject per convertire un GUID oggetto in un puntatore a oggetti. Per una descrizione più completa del modello di notifica, vedere Notifiche VDS.
Nella tabella seguente sono elencate le interfacce, le enumerazioni e le strutture correlate.
| Tipo | Elemento |
|---|---|
| Interfacce sempre esposte da questo oggetto | IVdsService, IVdsServiceHba*, IVdsServiceIscsi*, IVdsServiceUninstallDisk*. |
| Interfacce sempre implementate ma non esposte alle applicazioni | IVdsAdmin |
| Enumerazioni associate | VDS_QUERY_PROVIDER_FLAG, VDS_OBJECT_TYPE, VDS_SERVICE_FLAG, VDS_DRIVE_LETTER_FLAG, VDS_FILE_SYSTEM_FLAG, VDS_FILE_SYSTEM_PROP_FLAG. |
| Strutture associate | 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: Queste interfacce non sono supportate fino a Windows Server 2003 R2.
Oggetto Adapter Iniziatore
Un adattatore iniziatore modella un adattatore iniziatore iSCSI nel computer host del servizio VDS. Il servizio VDS può visualizzare solo le schede iniziatore nel computer locale. Il ruolo di un oggetto adattatore iniziatore consiste nella gestione delle sessioni di accesso dal computer locale alle destinazioni iSCSI.
Nella tabella seguente sono elencate le interfacce, le enumerazioni e le strutture correlate.
| Tipo | Elemento |
|---|---|
| Interfacce sempre esposte da questo oggetto | IVdsIscsiInitiatorAdapter*. |
| Enumerazioni associate | VDS_ISCSI_LOGIN_TYPE. VDS_ISCSI_LOGIN_FLAG, VDS_ISCSI_AUTH_TYPE. |
| Strutture associate | VDS_ISCSI_INITIATOR_ADAPTER_PROP. |
*Windows Server 2003: Questa interfaccia non è supportata fino a Windows Server 2003 R2.
Oggetto Portale iniziatore
Un oggetto del portale iniziatore modella un portale iniziatore iSCSI in un iniziatore iSCSI. Un portale iniziatore è la combinazione di un indirizzo IP e di una porta tramite cui un computer host si connette a un portale in un sottosistema iSCSI. Il ruolo di un oggetto portale iniziatore è quello di fungere da endpoint di un percorso MPIO e di configurare le impostazioni di sicurezza IPSEC.
Nella tabella seguente sono elencate le interfacce, le enumerazioni e le strutture correlate.
| Tipo | Elemento |
|---|---|
| Interfacce sempre esposte da questo oggetto | IVdsIscsiInitiatorPortal*. |
| Enumerazioni associate | VDS_ISCSI_IPSEC_FLAG. |
| Strutture associate | VDS_ISCSI_INITIATOR_PORTAL_PROP, VDS_ISCSI_IPSEC_KEY, VDS_IPADDRESS. |
*Windows Server 2003: Questa interfaccia non è supportata fino a Windows Server 2003 R2.
Oggetto Porta HBA
La porta HBA modella una porta HBA (Host Bus Adapter) Fibre Channel.
Utilizzare il metodo IVdsServiceHba::QueryHbaPorts per determinare le porte HBA note al VDS nel computer locale.
Nella tabella seguente sono elencate le interfacce, le enumerazioni e le strutture correlate.
| Tipo | Elemento |
|---|---|
| Interfacce sempre esposte da questo oggetto | IVdsHbaPort*. |
| Enumerazioni associate | VDS_HBAPORT_TYPE, VDS_HBAPORT_STATUS, VDS_HBAPORT_SPEED_FLAG. |
| Strutture associate | VDS_HBAPORT_PROP. |
*Windows Server 2003: Questa interfaccia non è supportata fino a Windows Server 2003 R2.
Argomenti correlati