Compartilhar via


Método IVdsVDisk::Open (vds.h)

[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.]

Abre um identificador para o arquivo de disco virtual especificado e retorna um ponteiro de interface IVdsOpenVDisk para o objeto que representa o identificador aberto.

Sintaxe

HRESULT Open(
  [in]  VIRTUAL_DISK_ACCESS_MASK AccessMask,
  [in]  OPEN_VIRTUAL_DISK_FLAG   Flags,
  [in]  ULONG                    ReadWriteDepth,
  [out] IVdsOpenVDisk            **ppOpenVDisk
);

Parâmetros

[in] AccessMask

Uma máscara de bits de sinalizadores de VIRTUAL_DISK_ACCESS_MASK especificando os direitos de acesso a serem aplicados ao disco virtual aberto.

[in] Flags

Uma máscara de bits de sinalizadores OPEN_VIRTUAL_DISK_FLAG especificando como o disco virtual deve ser aberto.

[in] ReadWriteDepth

O número de repositórios (arquivos de backup), começando com o filho, da cadeia de repositórios de backup para abrir leitura/gravação. Os repositórios restantes na cadeia de diferenciação serão abertos somente leitura. (Isso é necessário para que as operações de mesclagem tenham êxito.)

[out] ppOpenVDisk

Um ponteiro para uma variável que recebe um ponteiro de interface IVdsOpenVDisk para o objeto recém-criado que representa o identificador aberto para o objeto de disco virtual. Os chamadores devem liberar o ponteiro da interface quando ele não for mais necessário chamando o método IUnknown::Release .

Retornar valor

Esse método pode retornar valores HRESULT padrão, como E_INVALIDARG ou E_OUTOFMEMORY e valores retornados específicos do VDS. Ele também pode retornar códigos de erro do sistema convertidos usando a macro HRESULT_FROM_WIN32 . Os erros podem ser originados do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.

Código de retorno Descrição
S_OK
O método foi concluído com sucesso.

Comentários

Os aplicativos devem inicializar a segurança em todo o processo chamando a função CoInitializeSecurity . O parâmetro dwImpLevel deve ser definido como RPC_C_IMP_LEVEL_IMPERSONATE.

Windows Server 2008, Windows Vista e Windows Server 2003: Essas ações não são necessárias até o Windows 7 e o Windows Server 2008 R2.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vds.h
Biblioteca Uuid.lib

Confira também

IVdsVDisk