Freigeben über

FSCTL_GET_BOOT_AREA_INFO Steuerungscode

  • Artikel

Der FSCTL_GET_BOOT_AREA_INFO-Steuerelementcode ruft die Speicherorte von Startsektoren für ein Volume ab.

Rufen Sie zum Ausführen dieses Vorgangs die Funktion FltFsControlFile oder die Funktion ZwFsControlFile mit den folgenden Parametern auf.

Parameter

  • FileObject [in]: Nur FltFsControlFile . Ein Dateiobjektzeiger für das Volume, für das FSCTL_GET_BOOT_AREA_INFO die Startinformationen abruft. Dieser Parameter ist erforderlich und darf nicht NULL sein.

  • FileHandle [in]: nur ZwFsControlFile . Ein Dateihandle für das Volume, für das FSCTL_GET_BOOT_AREA_INFO die Startinformationen abruft. Dieser Parameter ist erforderlich und darf nicht NULL sein.

    Dieses Handle muss mit dem SE_MANAGE_VOLUME_NAME-Zugriffsrechten geöffnet werden. Weitere Informationen finden Sie unter Dateisicherheit und Zugriffsrechte.

  • FsControlCode [in]: Ein Steuerelementcode für den Vorgang. Verwenden Sie für diesen Vorgang FSCTL_GET_BOOT_AREA_INFO .

  • InputBuffer [in]: Wird bei diesem Vorgang nicht verwendet. Auf NULL festgelegt.

  • InputBufferLength [in]: Bei diesem Vorgang nicht verwendet. Auf NULL festlegen.

  • OutputBuffer [out]: Ein Zeiger auf eine BOOT_AREA_INFO-Struktur , die den Speicherort der Startsektoren des Volumes empfängt.

  • OutputBufferLength [out]: Die Größe des Ausgabepuffers in Bytes.

Statusblock

FltFsControlFile oder ZwFsControlFile gibt einen entsprechenden NTSTATUS-Wert zurück, z. B. einen der folgenden:

Code Bedeutung
STATUS_SUCCESS Der Vorgang wurde durchgeführt. OutputBuffer enthält einen Zeiger auf eine BOOT_AREA_INFO-Struktur .
STATUS_INVALID_PARAMETER Ein Parameter war ungültig. Beispielsweise ist das verwendete Handle kein gültiges Volumehandle.
STATUS_BUFFER_TOO_SMALL OutputBuffer ist nicht groß genug für das Ergebnis. Es wurden keine Informationen in den Puffer geschrieben.
STATUS_ACCESS_DENIED Der Benutzer hat keinen SE_MANAGE_VOLUME Zugriff.

Hinweise

FSCTL_GET_BOOT_AREA_INFO Steuercode kann auf FastFAT- und exFAT-Geräten verwendet werden. Diese Funktion unterstützt die Verwendung von BitLocker für Geräte wie Flash-Laufwerke.

Anforderungen

Anforderungstyp Anforderung
Unterstützte Mindestversion (Client) Windows 7
Unterstützte Mindestversion (Server) Windows Server 2008 R2
Header Ntifs.h (einschließlich Ntifs.h oder Fltkernel.h)

Siehe auch

DeviceIoControl