Função ZwSetVolumeInformationFile (ntifs.h)
A rotina ZwSetVolumeInformationFile modifica informações sobre o volume associado a um determinado arquivo, diretório, dispositivo de armazenamento ou volume.
Sintaxe
NTSYSAPI NTSTATUS ZwSetVolumeInformationFile(
[in] HANDLE FileHandle,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[in] PVOID FsInformation,
[in] ULONG Length,
[in] FS_INFORMATION_CLASS FsInformationClass
);
Parâmetros
[in] FileHandle
Manipule para um objeto de arquivo para um arquivo aberto, diretório, dispositivo de armazenamento ou volume cujas informações de volume devem ser modificadas.
[out] IoStatusBlock
Ponteiro para uma estrutura IO_STATUS_BLOCK que recebe o status de conclusão final e informações sobre a operação.
[in] FsInformation
Ponteiro para um buffer alocado pelo chamador que contém as informações de volume a serem modificadas. A estrutura das informações nesse buffer depende do valor de FsInformationClass, conforme mostrado na tabela a seguir.
[in] Length
Tamanho em bytes do buffer apontado por FsInformation. O chamador deve definir esse parâmetro de acordo com o FsInformationClass especificado.
[in] FsInformationClass
Tipo de informações de volume a serem definidas. Um dos seguintes:
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
ZwSetVolumeInformationFile retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:
Código de retorno | Descrição |
---|---|
|
Um valor inválido foi especificado para Length. Este é um código de erro. |
|
ZwSetVolumeInformationFile encontrou uma falha de alocação de pool. Este é um código de erro. |
|
Um valor inválido foi especificado para FsInformationClass. Este é um código de erro. |
Comentários
Para consultar informações de volume, chame ZwQueryVolumeInformationFile.
Para alterar informações sobre um arquivo, chame ZwSetVolumeInformationFile.
Os minifilters devem usar FltSetInformationFile em vez de ZwSetVolumeInformationFile.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Server 2003 |
Plataforma de Destino | Universal |
Cabeçalho | ntifs.h (inclua Ntifs.h) |
Biblioteca | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
Regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |
Confira também
Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo