Windows Win32Registroadvapi32.dll
RegNotifyChangeKeyValue
Monitora uma chave do Registro, notificando (de forma síncrona ou assíncrona) quando ela ou suas subchaves mudam.
Descrição
Equivalente funcional aproximado do inotify do Linux, mas específico para o Registro.
Header:
winreg.hDLL: advapi32.dllNative API: NtNotifyChangeKeyAssinatura
LSTATUS RegNotifyChangeKeyValue(
HKEY hKey,
BOOL bWatchSubtree,
DWORD dwNotifyFilter,
HANDLE hEvent,
BOOL fAsynchronous
);Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| hKey | HKEY | Handle da chave a monitorar, aberto com KEY_NOTIFY. |
| bWatchSubtree | BOOL | Se TRUE, monitora também subchaves recursivamente. |
| dwNotifyFilter | DWORD | REG_NOTIFY_CHANGE_NAME, REG_NOTIFY_CHANGE_LAST_SET, etc. |
| hEvent | HANDLE | Evento a sinalizar (modo assíncrono), ou NULL para bloquear (modo síncrono). |
| fAsynchronous | BOOL | Se TRUE, retorna imediatamente e sinaliza `hEvent` na mudança. |
Valor de retorno
ERROR_SUCCESS em sucesso; um código de erro do Windows caso contrário.
Códigos de erro (GetLastError)
- ERROR_INVALID_HANDLE(6)
- O identificador (handle) informado é inválido.
- ERROR_INVALID_PARAMETER(87)
- Parâmetro incorreto.