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

  • Artículo

[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows.]

Devuelve un puntero de objeto para el objeto identificado.

Sintaxis

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

Parámetros

[in] ObjectId

GUID del objeto deseado.

[in] type

Valor de enumeración VDS_OBJECT_TYPE que especifica el tipo de objeto. no se admiten VDS_OT_UNKNOWN, VDS_OT_PROVIDER, VDS_OT_ASYNC, VDS_OT_ENUM ni VDS_OT_OPEN_VDISK .

[out] ppObjectUnk

Puntero a un búfer que recibe el puntero IUnknown al objeto . Cuando el puntero ya no es necesario, el autor de la llamada debe liberarlo llamando al método IUnknown::Release .

Valor devuelto

Este método puede devolver valores HRESULT estándar, como E_INVALIDARG o E_OUTOFMEMORY, y valores devueltos específicos de VDS. También puede devolver códigos de error del sistema convertidos mediante la macro HRESULT_FROM_WIN32 . Los errores se pueden originar en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los posibles valores devueltos se incluyen los siguientes.

Código o valor devuelto Descripción
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 No se encuentra un objeto con el identificador y el tipo especificados.
VDS_E_INITIALIZED_FAILED
0x80042401L
 VDS no se pudo inicializar. Si una aplicación llama a este método antes de que el servicio termine de inicializarse, el método se bloqueará hasta que se complete la inicialización. Si se produce un error en la inicialización, se devuelve este error.

Comentarios

Las notificaciones de VDS devuelven un identificador de objeto en lugar de un puntero de objeto. Los autores de llamadas usan este método para obtener un puntero al objeto al que se hace referencia en la notificación.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vds.h
Library Uuid.lib

Consulte también

IVdsService

VDS_OBJECT_TYPE