Objetos de inicialização e serviço
[A partir do Windows 8 e do Windows Server 2012, o Virtual Disk Service interface COM é substituído 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 do carregador de serviços
O objeto do carregador de serviços 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 do carregador de serviços, que retorna a interfaceIVdsServiceLoader.
- Chame o IVdsServiceLoader::LoadService método para carregar o serviço.
Para obter um exemplo de código, consulte Carregando VDS.
Sempre permita que o serviço inicialize completamente antes de chamar os métodos que são expostos pelo objeto de serviço. Use o IVdsService::IsServiceReady método 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.
| Tipo | Elemento |
|---|---|
| Interfaces que são sempre expostas por este objeto | IVdsServiceLoader. |
| Enumerações associadas | Nenhuma. |
| Estruturas associadas | Nenhuma. |
Objeto de serviço
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 fornecedores de hardware ou software registados no VDS.
- Relatório sobre discos não alocados.
- Retornar o tipo de sistema de arquivos e a letra da unidade associada aos volumes em um disco.
- Remova caminhos de modo de usuário não utilizados e pastas montadas do registro e atualize os discos.
- Receba notificações VDS.
- Reinicialize o host.
- Recupere portas HBA Fibre Channel ou adaptadores de iniciador iSCSI no computador local.
- Prepare com segurança LUNs expostos como discos no computador local para remoção.
As estruturas de notificação 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 de notificações VDS .
A tabela a seguir lista interfaces, enumerações e estruturas relacionadas.
| Tipo | Elemento |
|---|---|
| Interfaces que são sempre expostas por este 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 são suportadas até o Windows Server 2003 R2.
Objeto do adaptador do iniciador
Um objeto de adaptador de iniciador modela um adaptador de iniciador iSCSI na máquina host do serviço VDS. O serviço VDS só pode visualizar adaptadores de iniciador na máquina local. A função de um objeto de adaptador iniciador é gerenciar sessões de login do computador local para destinos iSCSI.
A tabela a seguir lista interfaces, enumerações e estruturas relacionadas.
| Tipo | Elemento |
|---|---|
| Interfaces que são sempre expostas por este 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: Esta interface não é suportada até ao Windows Server 2003 R2.
Objeto do Portal do Iniciador
Um objeto de portal do iniciador modela um portal do iniciador iSCSI em um iniciador iSCSI. Um portal iniciador é a combinação de um endereço IP e uma porta através da qual um computador host se conecta a um portal em um subsistema iSCSI. A função de um objeto de portal do 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, enumerações e estruturas relacionadas.
| Tipo | Elemento |
|---|---|
| Interfaces que são sempre expostas por este 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: Esta interface não é suportada até ao Windows Server 2003 R2.
Objeto de porta HBA
O objeto de porta HBA modela uma porta HBA (Host Bus Adapter, 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, enumerações e estruturas relacionadas.
| Tipo | Elemento |
|---|---|
| Interfaces que são sempre expostas por este objeto | IVdsHbaPort*. |
| Enumerações associadas | VDS_HBAPORT_TYPE, VDS_HBAPORT_STATUS, VDS_HBAPORT_SPEED_FLAG. |
| Estruturas associadas | VDS_HBAPORT_PROP. |
*Windows Server 2003: Esta interface não é suportada até ao Windows Server 2003 R2.
Tópicos relacionados