Share via


FSCTL_GET_BOOT_AREA_INFO codice di controllo

Il codice di controllo FSCTL_GET_BOOT_AREA_INFO recupera le posizioni dei settori di avvio per un volume.

Per eseguire questa operazione, chiamare la funzione FltFsControlFile o ZwFsControlFile con i parametri seguenti.

Parametri

  • FileObject [in]: Solo FltFsControlFile . Puntatore a oggetti file per il volume per il quale FSCTL_GET_BOOT_AREA_INFO recupera le informazioni di avvio. Questo parametro è obbligatorio e non può essere NULL.

  • FileHandle [in]: ZwFsControlFile solo. Handle di file per il volume per il quale FSCTL_GET_BOOT_AREA_INFO recupera le informazioni di avvio. Questo parametro è obbligatorio e non può essere NULL.

    Questo handle deve essere aperto con i diritti di accesso SE_MANAGE_VOLUME_NAME. Per altre informazioni, vedere Sicurezza file e diritti di accesso.

  • FsControlCode [in]: codice di controllo per l'operazione. Usare FSCTL_GET_BOOT_AREA_INFO per questa operazione.

  • InputBuffer [in]: non usato con questa operazione. Impostare su NULL.

  • InputBufferLength [in]: non usato con questa operazione. Imposta su zero.

  • OutputBuffer [out]: puntatore a una struttura BOOT_AREA_INFO , che riceve la posizione dei settori di avvio del volume.

  • OutputBufferLength [out]: dimensioni del buffer di output, in byte.

Blocco dello stato

FltFsControlFile o ZwFsControlFile restituisce un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice Significato
STATUS_SUCCESS L'operazione è stata completata. OutputBuffer contiene un puntatore a una struttura BOOT_AREA_INFO .
STATUS_INVALID_PARAMETER Un parametro non è stato valido; ad esempio, l'handle usato non è un handle di volume valido.
STATUS_BUFFER_TOO_SMALL OutputBuffer non è abbastanza grande per il risultato. Nessuna informazione è stata scritta nel buffer.
STATUS_ACCESS_DENIED L'utente non ha accesso SE_MANAGE_VOLUME.

Commenti

FSCTL_GET_BOOT_AREA_INFO codice di controllo può essere usato nei dispositivi FastFAT ed exFAT. Questa funzionalità supporta l'uso di BitLocker per dispositivi come le unità flash.

Requisiti

Tipo di requisito Requisito
Client minimo supportato Windows 7
Server minimo supportato Windows Server 2008 R2
Intestazione Ntifs.h (include Ntifs.h o Fltkernel.h)

Vedi anche

Deviceiocontrol