Objetos de inicialização e serviço
[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]
O VDS fornece objetos para executar atividades relacionadas ao serviço. Este tópico descreve cada objeto.
Objeto Carregador de Serviço
O objeto carregador de serviço fornece os métodos usados pelos aplicativos para carregar e inicializar o VDS. Para preparar o VDS para uso, um aplicativo deve executar as seguintes operações:
- Crie uma instância do objeto carregador de serviço, que retorna a interface IVdsServiceLoader .
- Chame o método IVdsServiceLoader::LoadService para carregar o serviço.
Para obter um exemplo de código, consulte Carregando VDS.
Sempre permita que o serviço seja inicializado completamente antes de chamar os métodos expostos pelo objeto de serviço. Use o método IVdsService::IsServiceReady para determinar o status do processo de carga. Use o método IVdsService::WaitForServiceReady para bloquear chamadas para objetos VDS até que a inicialização seja concluída.
A tabela a seguir lista interfaces, enumerações e estruturas relacionadas.
| Type | Elemento |
|---|---|
| Interfaces que são sempre expostas por esse objeto | IVdsServiceLoader. |
| Enumerações associadas | Nenhum. |
| Estruturas associadas | Nenhum. |
Objeto service
O objeto de serviço é um objeto multifuncional que é central para todos os aplicativos VDS. Com esse objeto, um chamador pode executar as seguintes operações:
- Determine o status da inicialização do serviço.
- Recupere todos os provedores de hardware ou software registrados no VDS.
- Relatório sobre discos não alocados.
- Retornar o tipo de sistema de arquivos e a letra da unidade associadas a volumes em um disco.
- Remova caminhos não utilizados do modo de usuário e pastas montadas do registro e atualize os discos.
- Receber notificações do VDS.
- Reinicie o host.
- Recupere portas HBA do Fibre Channel ou adaptadores do iniciador iSCSI no computador local.
- Prepare com segurança LUNs expostos como discos no computador local para remoção.
As estruturas de notificação do VDS passam GUIDs de objeto para todos os aplicativos registrados no VDS para receber notificações. Use o método IVdsService::GetObject para converter um GUID de objeto em um ponteiro de objeto. Para obter uma descrição mais completa do modelo de notificação, consulte Notificações do VDS.
A tabela a seguir lista interfaces, enumerações e estruturas relacionadas.
| Type | Elemento |
|---|---|
| Interfaces que são sempre expostas por esse objeto | IVdsService, IVdsServiceHba*, IVdsServiceIscsi*, IVdsServiceUninstallDisk*. |
| Interfaces que são sempre implementadas, mas não expostas a aplicativos | IVdsAdmin |
| Enumerações associadas | VDS_QUERY_PROVIDER_FLAG, VDS_OBJECT_TYPE, VDS_SERVICE_FLAG, VDS_DRIVE_LETTER_FLAG, VDS_FILE_SYSTEM_FLAG, VDS_FILE_SYSTEM_PROP_FLAG. |
| Estruturas associadas | 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: Essas interfaces não têm suporte até o Windows Server 2003 R2.
Objeto do Adaptador do Iniciador
Um objeto do adaptador iniciador modela um adaptador iniciador iSCSI no computador host do serviço VDS. O serviço VDS só pode exibir adaptadores iniciadores no computador local. A função de um objeto de adaptador iniciador é para gerenciar sessões de logon do computador local para destinos iSCSI.
A tabela a seguir lista interfaces, enumerações e estruturas relacionadas.
| Type | Elemento |
|---|---|
| Interfaces que são sempre expostas por esse objeto | IVdsIscsiInitiatorAdapter*. |
| Enumerações associadas | VDS_ISCSI_LOGIN_TYPE. VDS_ISCSI_LOGIN_FLAG, VDS_ISCSI_AUTH_TYPE. |
| Estruturas associadas | VDS_ISCSI_INITIATOR_ADAPTER_PROP. |
*Windows Server 2003: Essa interface não tem suporte até o Windows Server 2003 R2.
Objeto Portal do Iniciador
Um objeto do portal do iniciador modela um portal iniciador iSCSI em um iniciador iSCSI. Um portal iniciador é a combinação de um endereço IP e uma porta por meio da qual um computador host se conecta a um portal em um subsistema iSCSI. A função de um objeto de portal iniciador é servir como um dos pontos de extremidade de um caminho MPIO e definir as configurações de segurança IPSEC.
A tabela a seguir lista as interfaces, as enumerações e as estruturas relacionadas.
| Type | Elemento |
|---|---|
| Interfaces que são sempre expostas por esse objeto | IVdsIscsiInitiatorPortal*. |
| Enumerações associadas | VDS_ISCSI_IPSEC_FLAG. |
| Estruturas associadas | VDS_ISCSI_INITIATOR_PORTAL_PROP, VDS_ISCSI_IPSEC_KEY, VDS_IPADDRESS. |
*Windows Server 2003: Essa interface não tem suporte até o Windows Server 2003 R2.
Objeto de porta HBA
O objeto de porta HBA modela uma porta HBA (adaptador de barramento de host) fibre channel.
Use o método IVdsServiceHba::QueryHbaPorts para determinar as portas HBA conhecidas pelo VDS no computador local.
A tabela a seguir lista as interfaces, as enumerações e as estruturas relacionadas.
| Type | Elemento |
|---|---|
| Interfaces que são sempre expostas por esse objeto | IVdsHbaPort*. |
| Enumerações associadas | VDS_HBAPORT_TYPE, VDS_HBAPORT_STATUS, VDS_HBAPORT_SPEED_FLAG. |
| Estruturas associadas | VDS_HBAPORT_PROP. |
*Windows Server 2003: Essa interface não tem suporte até o Windows Server 2003 R2.
Tópicos relacionados