Método IVdsOpenVDisk::Attach (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.]

Anexa um disco virtual.

Sintaxe

HRESULT Attach(
  [in]  LPWSTR                   pStringSecurityDescriptor,
  [in]  ATTACH_VIRTUAL_DISK_FLAG Flags,
  [in]  ULONG                    ProviderSpecificFlags,
  [in]  ULONG                    TimeoutInMs,
  [out] IVdsAsync                **ppAsync
);

Parâmetros

[in] pStringSecurityDescriptor

Uma cadeia de caracteres que contém o descritor de segurança para o disco virtual. Se não for especificado, o descritor de segurança em uso será: "D:P(A;; GA;;; WD)" no Windows 7 e "D:P(A;; GA;;; WD)(A;; GA;;; AC)" no Windows 8.1 e posterior.

[in] Flags

Uma máscara de bits de ATTACH_VIRTUAL_DISK_FLAG valores de enumeração que especificam como o disco virtual deve ser anexado. Os possíveis valores incluem os seguintes.

[in] ProviderSpecificFlags

Uma máscara de bits de sinalizadores que são específicos para o tipo de disco virtual que está sendo anexado. Esses sinalizadores são específicos do provedor. Para o provedor de disco virtual da Microsoft, esse parâmetro deve ser zero.

[in] TimeoutInMs

Esse parâmetro é reservado para uso futuro.

[out] ppAsync

Um ponteiro para uma interface IVdsAsync que, após a conclusão bem-sucedida, recebe a interface IVdsAsync para monitorar e controlar essa operação. Os chamadores devem liberar a interface recebida quando tiverem terminado com ela. Se o método IVdsAsync::Wait for chamado na interface e um valor HRESULT bem-sucedido for retornado, as interfaces retornadas na estrutura VDS_ASYNC_OUTPUT deverão ser liberadas chamando o método IUnknown::Release em cada ponteiro de interface. No entanto, se Wait retornar um valor HRESULT de falha ou se o parâmetro pHrResult de Wait receber um valor HRESULT de falha, os ponteiros de interface na estrutura VDS_ASYNC_OUTPUT serão NULL e não precisarão ser liberados. Você pode testar valores HRESULT com êxito ou falha usando as macros SUCCEEDED e FAILED definidas em Winerror.h.

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.

Comentários

Quando um disco virtual é anexado, o chamador pode receber uma ou todas as seguintes notificações:

• Se o chamador estiver registrado para notificações do VDS, o chamador receberá uma notificação de chegada em disco. Para obter mais informações, consulte Notificações do VDS.
• Se o chamador estiver registrado para notificações PnP, o chamador receberá uma notificação de chegada do disco PnP. Para obter mais informações, consulte RegisterDeviceNotification.

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

Confira também

IVdsOpenVDisk