Compartir a través de

Método IVdsVolume2::GetProperties2 (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 información de propiedad para el volumen actual. Este método es idéntico al método IVdsVolume::GetProperties , salvo que devuelve una estructura de VDS_VOLUME_PROP2 en lugar de una estructura VDS_VOLUME_PROP .

Sintaxis

HRESULT GetProperties2(
  [out] VDS_VOLUME_PROP2 *pVolumeProperties
);

Parámetros

[out] pVolumeProperties

Dirección de la estructura de VDS_VOLUME_PROP2 asignada y pasada por el autor de la llamada. VDS asigna memoria para la cadena de miembro pwszName . Los autores de llamadas deben liberar la cadena 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 pueden originarse en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los valores devueltos posibles se incluyen los siguientes.

Código o valor devuelto Descripción
S_OK
 El método se completó correctamente.
VDS_S_PROPERTIES_INCOMPLETE
0x00042715L
 Algunas pero no todas las propiedades se recuperaron correctamente. Tenga en cuenta que hay muchas razones posibles por las que no se pueden recuperar todas las propiedades, incluida la eliminación de dispositivos.

Comentarios

Este método recupera el identificador de volumen único de un volumen. Estructura que contiene ese identificador es VDS_VOLUME_PROP2, no VDS_VOLUME_PROP.

Tenga en cuenta que un identificador de volumen único no es el mismo que una ruta de acceso GUID de volumen. Para buscar las rutas de acceso GUID de volumen de un volumen, use el método IVdsVolumeMF3::QueryVolumeGuidPathnames .

Requisitos

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

Consulte también

IVdsVolume2