Função FltSetVolumeInformation (fltkernel.h)

Artigo
08/07/2023

FltSetVolumeInformation altera vários tipos de informações sobre o volume ao qual a instância determinada está anexada.

Sintaxe

NTSTATUS FLTAPI FltSetVolumeInformation(
  [in]  PFLT_INSTANCE        Instance,
  [out] PIO_STATUS_BLOCK     Iosb,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

Parâmetros

[in] Instance

Ponteiro de instância opaca para uma instância de driver de minifiltro anexada ao volume.

[out] Iosb

Ponteiro para uma estrutura IO_STATUS_BLOCK que recebe o status de conclusão final e informações sobre a operação.

[out] FsInformation

Ponteiro para um buffer alocado pelo chamador que contém os valores a serem definidos para o volume. A estrutura das informações contidas no buffer é definida pelo parâmetro FsInformationClass .

[in] Length

Tamanho em bytes do buffer para o qual FsInformation aponta. O chamador deve definir esse parâmetro de acordo com o FsInformationClass especificado. Por exemplo, se o valor de FsInformationClass for FileFsControlInformation, Length deverá ser pelo menos sizeof(FILE_FS_CONTROL_INFORMATION).

[in] FsInformationClass

Tipo de informação a ser definida para o volume. Uma das opções a seguir.

Valor	Significado
FileFsControlInformation	Defina FILE_FS_CONTROL_INFORMATION para o volume.
FileFsLabelInformation	Defina FILE_FS_LABEL_INFORMATION para o volume.
FileFsObjectIdInformation	Defina FILE_FS_OBJECTID_INFORMATION para o volume.

Retornar valor

FltSetVolumeInformation retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno	Descrição
STATUS_INFO_LENGTH_MISMATCH	Um valor inválido foi especificado para Length. Este é um código de erro.
STATUS_INSUFFICIENT_RESOURCES	FltSetVolumeInformation encontrou uma falha de alocação de pool. Este é um código de erro.
STATUS_INVALID_INFO_CLASS	Um valor inválido foi especificado para FsInformationClass. Este é um código de erro.
STATUS_INVALID_PARAMETER	A Instância é anexada a um volume de rede. FltSetVolumeInformation não pode ser usado para definir informações de volume de rede. Este é um código de erro.