estructura FILE_FS_OBJECTID_INFORMATION (ntddk.h)
La estructura FILE_FS_OBJECTID_INFORMATION se usa para consultar o establecer el identificador de objeto de un volumen del sistema de archivos.
Sintaxis
typedef struct _FILE_FS_OBJECTID_INFORMATION {
UCHAR ObjectId[16];
UCHAR ExtendedInfo[48];
} FILE_FS_OBJECTID_INFORMATION, *PFILE_FS_OBJECTID_INFORMATION;
Miembros
ObjectId[16]
GUID de 16 bytes que identifica el volumen del sistema de archivos en el disco.
ExtendedInfo[48]
Valor de 48 bytes que contiene información opcional definida por el autor de la llamada en el volumen del sistema de archivos. El significado de esta información extendida es opaco para el sistema de archivos.
Comentarios
Esta información se puede consultar de cualquiera de las maneras siguientes:
- Llame a FltQueryVolumeInformation o ZwQueryVolumeInformationFile, pasando FileFsObjectIdInformation como valor de FileInformationClass y pasando un búfer asignado por el autor de la llamada FILE_FS_OBJECTID_INFORMATION como valor de FileInformation.
- Cree un IRP con el código de función principal IRP_MJ_QUERY_VOLUME_INFORMATION.
No se requieren derechos de acceso específicos para consultar esta información. Por lo tanto, esta información está disponible siempre que se acceda al volumen a través de un identificador abierto al propio volumen, o a un archivo o directorio del volumen.
Esta información se puede establecer de cualquiera de las siguientes maneras:
- Llame a FltSetVolumeInformation o ZwSetVolumeInformationFile, pasando FileFsObjectIdInformation como valor de FileInformationClass y pasando un búfer asignado por el autor de la llamada FILE_FS_OBJECTID_INFORMATION como valor de FileInformation.
- Cree un IRP con el código de función principal IRP_MJ_SET_VOLUME_INFORMATION.
FILE_WRITE_DATA se requiere acceso al volumen para establecer esta información.
La compatibilidad con identificadores de objeto de volumen es específica del sistema de archivos. En NTFS, el servicio de seguimiento de vínculos distribuidos usa ampliamente los identificadores de objeto de volumen.
Es importante tener en cuenta que el identificador del objeto de volumen no es el mismo que el GUID del volumen. El sistema de archivos asigna el identificador de objeto de volumen al volumen del sistema de archivos. El GUID del volumen, o nombre de volumen único, es independiente del sistema de archivos; el Administrador de montaje de volúmenes asigna al volumen de almacenamiento subyacente.
Para obtener el GUID de volumen de un volumen, use la función GetVolumeNameForVolumeMountPointW de Win32 o la rutina FltGetVolumeGuidName .
El tamaño del búfer pasado en el parámetro FileInformation a FltQueryVolumeInformation, FltSetVolumeInformation, ZwQueryVolumeInformationFile o ZwSetVolumeInformationFile debe ser al menos sizeof (FILE_FS_OBJECTID_INFORMATION).
Esta estructura debe alinearse en un límite de LONGLONG (8 bytes).
Requisitos
| Requisito | Valor |
|---|---|
| Header | ntddk.h (incluya Ntddk.h, Ntifs.h, Fltkernel.h) |