Método IVdsDisk3::GetProperties2 (vds.h)

[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 información de propiedad para un disco. Este método es idéntico al método IVdsDisk::GetProperties , salvo que devuelve una estructura VDS_DISK_PROP2 en lugar de una estructura VDS_DISK_PROP .

Sintaxis

HRESULT GetProperties2(
  [out] VDS_DISK_PROP2 *pDiskProperties
);

Parámetros

[out] pDiskProperties

Dirección de la estructura de VDS_DISK_PROP2 asignada y pasada por el autor de la llamada. VDS asigna memoria para las cadenas de miembro pwszDiskAddress, pwszName, pwszFriendlyName, pwszAdaptorName, pwszDevicePath y pwszLocationPath . Los autores de llamadas deben liberar las cadenas mediante la función CoTaskMemFree .

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.

Observaciones

En la estructura VDS_DISK_PROP2 que se devuelve en el parámetro pDiskProperties , el miembro pwszDiskAddress es opcional y puede ser NULL si no hay ningún valor disponible. Los autores de llamadas de este método deben comprobar si este miembro es NULL.

Para Hyper-V, el miembro pwszLocationPath es NULL, porque el controlador virtual no devuelve la ruta de acceso de ubicación.

Requisitos

Consulte también

IVdsDisk3

VDS_DISK_PROP2