estructura VDS_VOLUME_PROP2 (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.]
Define las propiedades de un objeto de volumen. Esta estructura es idéntica a la estructura de VDS_VOLUME_PROP , salvo que también incluye los GUID de volumen.
Sintaxis
typedef struct _VDS_VOLUME_PROP2 {
VDS_OBJECT_ID id;
VDS_VOLUME_TYPE type;
VDS_VOLUME_STATUS status;
VDS_HEALTH health;
VDS_TRANSITION_STATE TransitionState;
ULONGLONG ullSize;
ULONG ulFlags;
VDS_FILE_SYSTEM_TYPE RecommendedFileSystemType;
ULONG cbUniqueId;
LPWSTR pwszName;
BYTE *pUniqueId;
} VDS_VOLUME_PROP2, *PVDS_VOLUME_PROP2;
Miembros
id
GUID del volumen.
type
Valor de enumeración VDS_VOLUME_TYPE que especifica el tipo de volumen. Los tipos de volumen son simples, distribuidos, seccionados (RAID-0), reflejados o seccionados con paridad (RAID-5).
status
Valor de enumeración VDS_VOLUME_STATUS que especifica el estado del volumen.
health
Valor de enumeración VDS_HEALTH que especifica el estado de mantenimiento del volumen.
TransitionState
Valor de enumeración VDS_TRANSITION_STATE que especifica el estado de transición del volumen.
ullSize
Tamaño del volumen, en bytes.
ulFlags
Máscara de bits de VDS_VOLUME_FLAG valores de enumeración que describen el volumen.
RecommendedFileSystemType
Valor de enumeración VDS_FILE_SYSTEM_TYPE que especifica el sistema de archivos preferido para el volumen. Debe ser uno de los siguientes: VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32, VDS_FST_UDF, VDS_FST_CDFS o VDS_FST_UNKNOWN.
cbUniqueId
Longitud de la matriz de bytes a la que apunta el miembro pUniqueId .
pwszName
Nombre que se usó para abrir un identificador para el volumen con la función CreateFile . Por ejemplo, \?\GLOBALROOT\Device\HarddiskVolume1.
pUniqueId
Matriz de bytes que contiene el identificador único del volumen.
Comentarios
El método IVdsVolume2::GetProperties2 devuelve esta estructura para informar de las propiedades de un objeto de volumen.
Cuando un volumen está sin conexión, la marca de VDS_VF_PERMANENTLY_DISMOUNTED se establece en el miembro ulFlags de la estructura VDS_VOLUME_PROP2 y el valor de estado del volumen de VDS_VS_OFFLINE también se establece en el miembro de estado de esta estructura.
En el caso de los volúmenes GPT y dinámicos, el identificador único al que apunta el miembro pUniqueId es único globalmente.
En el caso de las unidades de medios extraíbles, el volumen existe y tiene su propio identificador único, incluso si no hay ningún medio en el dispositivo. Si un volumen tiene formato en medios extraíbles, ese volumen tiene su propio identificador único. Para obtener más información, vea Admitir solicitudes del Administrador de montaje en un controlador de clase de almacenamiento.
El formato del identificador único puede variar entre diferentes tipos de dispositivos y volúmenes. En el caso de los volúmenes básicos en discos MBR, el identificador único se basa en la firma del disco y el desplazamiento de partición. Dado que la firma de disco y el desplazamiento de partición son valores DWORD, no se puede garantizar que el identificador único sea globalmente único en todos los equipos.
Si cambia la firma del disco, el identificador único del volumen también cambia. Los cambios de firma de disco suelen producirse como resultado de una colisión durante la clonación de disco.
Tenga en cuenta que un identificador ú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] |
| Encabezado | vds.h |