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