Método IVdsService::GetObject (vds.h)

  • Artigo

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

Retorna um ponteiro de objeto para o objeto identificado.

Sintaxe

HRESULT GetObject(
  [in]  VDS_OBJECT_ID   ObjectId,
  [in]  VDS_OBJECT_TYPE type,
  [out] IUnknown        **ppObjectUnk
);

Parâmetros

[in] ObjectId

O GUID do objeto desejado.

[in] type

Um VDS_OBJECT_TYPE valor de enumeração que especifica o tipo de objeto. não há suporte para VDS_OT_UNKNOWN, VDS_OT_PROVIDER, VDS_OT_ASYNC, VDS_OT_ENUM e VDS_OT_OPEN_VDISK .

[out] ppObjectUnk

Um ponteiro para um buffer que recebe o ponteiro IUnknown para o objeto . Quando o ponteiro não for mais necessário, o chamador deverá liberá-lo 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.

Valor/código retornado Descrição
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 Um objeto com o identificador e o tipo especificados não foi encontrado.
VDS_E_INITIALIZED_FAILED
0x80042401L
 Falha ao inicializar o VDS. Se um aplicativo chamar esse método antes que o serviço termine de inicializar, o método será bloqueado até que a inicialização seja concluída. Se a inicialização falhar, esse erro será retornado.

Comentários

As notificações do VDS retornam um identificador de objeto em vez de um ponteiro de objeto. Os chamadores usam esse método para obter um ponteiro para o objeto referenciado na notificação.

Requisitos

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

Confira também

IVdsService

VDS_OBJECT_TYPE