FSCTL_GET_BOOT_AREA_INFO código de controle

  • Artigo

O código de controle FSCTL_GET_BOOT_AREA_INFO recupera os locais dos setores de inicialização para um volume.

Para executar essa operação, chame a função FltFsControlFile ou a função ZwFsControlFile com os parâmetros a seguir.

Parâmetros

  • FileObject [in]: somente FltFsControlFile . Um ponteiro de objeto de arquivo para o volume para o qual FSCTL_GET_BOOT_AREA_INFO recuperará as informações de inicialização. Esse parâmetro é necessário e não pode ser NULL.

  • FileHandle [in]: somente ZwFsControlFile . Um identificador de arquivo para o volume para o qual FSCTL_GET_BOOT_AREA_INFO recuperará as informações de inicialização. Esse parâmetro é necessário e não pode ser NULL.

    Esse identificador deve ser aberto com os direitos de acesso SE_MANAGE_VOLUME_NAME. Para obter mais informações, consulte Segurança de arquivos e Direitos de Acesso.

  • FsControlCode [in]: um código de controle para a operação. Use FSCTL_GET_BOOT_AREA_INFO para esta operação.

  • InputBuffer [in]: não usado com essa operação. Defina como NULL.

  • InputBufferLength [in]: não usado com essa operação. Defina como zero.

  • OutputBuffer [out]: um ponteiro para uma estrutura BOOT_AREA_INFO , que recebe o local dos setores de inicialização do volume.

  • OutputBufferLength [out]: o tamanho do buffer de saída, em bytes.

Bloco de status

FltFsControlFile ou ZwFsControlFile retorna um valor NTSTATUS apropriado, como um dos seguintes:

Código Significado
STATUS_SUCCESS A operação foi bem-sucedida. OutputBuffer contém um ponteiro para uma estrutura de BOOT_AREA_INFO .
STATUS_INVALID_PARAMETER Um parâmetro não era válido; por exemplo, o identificador usado não é um identificador de volume válido.
STATUS_BUFFER_TOO_SMALL OutputBuffer não é grande o suficiente para o resultado. Nenhuma informação foi gravada no buffer.
STATUS_ACCESS_DENIED O usuário não tem acesso SE_MANAGE_VOLUME.

Comentários

FSCTL_GET_BOOT_AREA_INFO código de controle pode ser usado em dispositivos FastFAT e exFAT. Essa funcionalidade dá suporte ao uso do BitLocker para dispositivos como unidades flash.

Requisitos

Tipo de Requisito Requisito
Cliente mínimo com suporte Windows 7
Servidor mínimo com suporte Windows Server 2008 R2
parâmetro Ntifs.h (inclua Ntifs.h ou Fltkernel.h)

Confira também

DeviceIoControl