Oggetti di avvio e servizio

  • Articolo

[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:

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.

Modello a oggetti VDS

IVdsServiceLoader::LoadService

Caricamento di VDS

IVdsService::GetObject

Notifiche VDS