code de contrôle FSCTL_GET_BOOT_AREA_INFO
Le code de contrôle FSCTL_GET_BOOT_AREA_INFO récupère les emplacements des secteurs de démarrage d’un volume.
Pour effectuer cette opération, appelez la fonction FltFsControlFile ou la fonction ZwFsControlFile avec les paramètres suivants.
Paramètres
FileObject [in] : FltFsControlFile uniquement. Pointeur d’objet fichier pour le volume pour lequel FSCTL_GET_BOOT_AREA_INFO récupérerez les informations de démarrage. Ce paramètre est obligatoire et ne peut pas être NULL.
FileHandle [in] : ZwFsControlFile uniquement. Handle de fichier pour le volume pour lequel FSCTL_GET_BOOT_AREA_INFO récupérera les informations de démarrage. Ce paramètre est obligatoire et ne peut pas être NULL.
Ce handle doit être ouvert avec les droits d’accès SE_MANAGE_VOLUME_NAME. Pour plus d’informations, consultez Sécurité des fichiers et droits d’accès.
FsControlCode [in] : code de contrôle pour l’opération. Utilisez FSCTL_GET_BOOT_AREA_INFO pour cette opération.
InputBuffer [in] : non utilisé avec cette opération. Défini sur NULL.
InputBufferLength [in] : non utilisé avec cette opération. Définit la valeur zéro.
OutputBuffer [out] : pointeur vers une structure BOOT_AREA_INFO , qui reçoit l’emplacement des secteurs de démarrage du volume.
OutputBufferLength [out] : taille de la mémoire tampon de sortie, en octets.
Bloc d’état
FltFsControlFile ou ZwFsControlFile retourne une valeur NTSTATUS appropriée, telle que l’une des valeurs suivantes :
| Code | Signification |
|---|---|
| STATUS_SUCCESS | L'opération a réussi. OutputBuffer contient un pointeur vers une structure BOOT_AREA_INFO . |
| STATUS_INVALID_PARAMETER | Un paramètre n’était pas valide ; par exemple, le handle utilisé n’est pas un handle de volume valide. |
| STATUS_BUFFER_TOO_SMALL | OutputBuffer n’est pas assez grand pour le résultat. Aucune information n’a été écrite dans la mémoire tampon. |
| STATUS_ACCESS_DENIED | L’utilisateur n’a pas accès SE_MANAGE_VOLUME. |
Remarques
FSCTL_GET_BOOT_AREA_INFO code de contrôle peut être utilisé sur les appareils FastFAT et exFAT. Cette fonctionnalité prend en charge l’utilisation de BitLocker pour les appareils tels que les lecteurs flash.
Configuration requise
| Type d’exigence | Condition requise |
|---|---|
| Client minimal pris en charge | Windows 7 |
| Serveur minimal pris en charge | Windows Server 2008 R2 |
| En-tête | Ntifs.h (inclure Ntifs.h ou Fltkernel.h) |