Função ZwFlushKey (wdm.h)

A rotina ZwFlushKey força uma chave do Registro a ser confirmada no disco.

Sintaxe

NTSYSAPI NTSTATUS ZwFlushKey(
  [in] HANDLE KeyHandle
);

Parâmetros

[in] KeyHandle

Manipule para a chave do Registro a ser liberada para o disco. Esse identificador é criado por uma chamada bem-sucedida para ZwCreateKey ou ZwOpenKey.

Retornar valor

ZwFlushKey retorna STATUS_SUCCESS se as informações de chave foram transferidas para o disco ou o código de erro apropriado em caso de falha.

Comentários

Você pode liberar as alterações feitas por ZwCreateKey ou ZwSetValueKey chamando ZwFlushKey. Essa rotina não retorna até que todos os dados alterados associados ao KeyHandle sejam gravados em disco. ZwFlushKey libera todo o hive do Registro para a chave, que inclui todas as subchaves da chave especificada.

Essa rotina pode liberar todo o registro. Assim, ele pode gerar uma grande quantidade de E/S. Como o sistema libera as alterações de chave automaticamente a cada poucos segundos, você raramente precisa chamar ZwFlushKey.

Para obter mais informações sobre como trabalhar com chaves do Registro, consulte Usando o Registro em um Driver.

Se a chamada para essa função ocorrer no modo de usuário, você deverá usar o nome "NtFlushKey" em vez de "ZwFlushKey".

Para chamadas de drivers no modo kernel, as versões NtXxx e ZwXxx de uma rotina dos Serviços do Sistema Nativo do Windows podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), IrqlZwPassive(wdm), ZwRegistryCreate(storport), ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(wdm)

Confira também

Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo

ZwCreateKey

ZwOpenKey

ZwSetValueKey