FILE_FS_OBJECTID_INFORMATION-Struktur (ntddk.h)

Artikel
08/07/2023

Die FILE_FS_OBJECTID_INFORMATION-Struktur wird verwendet, um die Objekt-ID für ein Dateisystemvolume abzufragen oder festzulegen.

Syntax

typedef struct _FILE_FS_OBJECTID_INFORMATION {
  UCHAR ObjectId[16];
  UCHAR ExtendedInfo[48];
} FILE_FS_OBJECTID_INFORMATION, *PFILE_FS_OBJECTID_INFORMATION;

Member

ObjectId[16]

Eine 16-Byte-GUID, die das Dateisystemvolume auf dem Datenträger identifiziert.

ExtendedInfo[48]

Ein 48-Byte-Wert, der optionale, zusätzliche vom Aufrufer definierte Informationen auf dem Dateisystemvolume enthält. Die Bedeutung dieser erweiterten Informationen ist für das Dateisystem undurchsichtig.

Hinweise

Diese Informationen können auf eine der folgenden Arten abgefragt werden:

Rufen Sie FltQueryVolumeInformation oder ZwQueryVolumeInformationFile auf, übergeben Sie FileFsObjectIdInformation als Wert von FileInformationClass , und übergeben Sie einen aufruferseitig zugeordneten, FILE_FS_OBJECTID_INFORMATION strukturierten Puffer als Wert von FileInformation.
Erstellen Sie eine IRP mit hauptfunktionscode IRP_MJ_QUERY_VOLUME_INFORMATION.

Zum Abfragen dieser Informationen sind keine spezifischen Zugriffsrechte erforderlich. Daher sind diese Informationen verfügbar, solange auf das Volume über ein geöffnetes Handle auf das Volume selbst oder auf eine Datei oder ein Verzeichnis auf dem Volume zugegriffen wird.

Diese Informationen können auf eine der folgenden Arten festgelegt werden:

Rufen Sie FltSetVolumeInformation oder ZwSetVolumeInformationFile auf, übergeben Sie FileFsObjectIdInformation als Wert von FileInformationClass und übergeben Sie einen aufruferseitig zugewiesenen, FILE_FS_OBJECTID_INFORMATION strukturierten Puffer als Wert von FileInformation.
Erstellen Sie ein IRP mit hauptfunktionscode IRP_MJ_SET_VOLUME_INFORMATION.

FILE_WRITE_DATA Zugriff auf das Volume ist erforderlich, um diese Informationen festzulegen.

Die Unterstützung für Volumeobjekt-IDs ist dateisystemspezifisch. In NTFS werden Volumeobjekt-IDs vom Distributed Link Tracking-Dienst umfassend verwendet.

Beachten Sie, dass die Volumeobjekt-ID nicht mit der Volume-GUID identisch ist. Die Volumeobjekt-ID wird dem Dateisystemvolume vom Dateisystem zugewiesen. Die Volume-GUID oder der eindeutige Volumename ist dateisystemunabhängig. es wird dem zugrunde liegenden Speichervolume vom Volume Mount Manager zugewiesen.

Verwenden Sie zum Abrufen der Volume-GUID für ein Volume die Win32 GetVolumeNameForVolumeMountPointW-Funktion oder die FltGetVolumeGuidName-Routine .

Die Größe des Puffers, der im FileInformation-Parameter an FltQueryVolumeInformation, FltSetVolumeInformation, ZwQueryVolumeInformationFile oder ZwSetVolumeInformationFile übergeben wird, muss mindestens sizeof (FILE_FS_OBJECTID_INFORMATION) sein.

Diese Struktur muss an einer LONGLONG-Grenze (8 Byte) ausgerichtet werden.