Compartilhar via


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:

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.

Modelo de objeto VDS

IVdsServiceLoader::LoadService

Carregando VDS

IVdsService::GetObject

Notificações do VDS