FILE_FS_OBJECTID_INFORMATION Struktur (ntddk.h)
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;
Angehörige
ObjectId[16]
Eine 16-Byte-GUID, die das Dateisystemvolume auf dem Datenträger identifiziert.
ExtendedInfo[48]
Ein 48-Byte-Wert, der optionale, zusätzliche aufruferdefinierte Informationen auf dem Dateisystemvolume enthält. Die Bedeutung dieser erweiterten Informationen ist für das Dateisystem undurchsichtig.
Bemerkungen
Diese Informationen können auf eine der folgenden Arten abgefragt werden:
- Rufen Sie FltQueryVolumeInformation oder ZwQueryVolumeInformationFile-auf, und übergeben Sie FileFsObjectIdInformation als Wert von FileInformationClass und übergeben Sie einen zugeordneten, FILE_FS_OBJECTID_INFORMATION strukturierten Puffer als Wert von FileInformation.
- Erstellen Sie ein 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 für 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 ZwSetVolumeInformationFileauf, und übergeben Sie FileFsObjectIdInformation als Wert von FileInformationClass und übergeben Sie einen zugeordneten Aufrufer, 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.
Unterstützung für Volumeobjekt-IDs ist dateisystemspezifisch. In NTFS werden Volumeobjekt-IDs umfassend vom Verteilten Linkverfolgungsdienst verwendet.
Es ist wichtig zu beachten, dass die Volumeobjekt-ID nicht mit der Volume-GUID identisch ist. Die Volumeobjekt-ID wird dem Dateisystemvolume vom Dateisystem zugewiesen. Die Volume-GUIDoder eindeutigen Volumenamensist dateisystemunabhängig; sie wird dem zugrunde liegenden Speichervolume vom Volume Mount Manager zugewiesen.
Um die Volume-GUID für ein Volume abzurufen, verwenden Sie die Win32-GetVolumeNameForVolumeMountPointW--Funktion oder die FltGetVolumeGuidName Routine.
Die Größe des im FileInformation Parameter übergebenen Puffers an FltQueryVolumeInformation, FltSetVolumeInformation, ZwQueryVolumeInformationFileoder ZwSetVolumeInformationFile muss mindestens Größe (FILE_FS_OBJECTID_INFORMATION).
Diese Struktur muss an einer LONGLONG-Grenze (8-Byte) ausgerichtet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ntddk.h (include Ntddk.h, Ntifs.h, Fltkernel.h) |