Voltar à lista
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: NtNotifyChangeKey

Assinatura

LSTATUS RegNotifyChangeKeyValue(
    HKEY hKey,
    BOOL bWatchSubtree,
    DWORD dwNotifyFilter,
    HANDLE hEvent,
    BOOL fAsynchronous
);

Parâmetros

ParâmetroTipoDescrição
hKeyHKEYHandle da chave a monitorar, aberto com KEY_NOTIFY.
bWatchSubtreeBOOLSe TRUE, monitora também subchaves recursivamente.
dwNotifyFilterDWORDREG_NOTIFY_CHANGE_NAME, REG_NOTIFY_CHANGE_LAST_SET, etc.
hEventHANDLEEvento a sinalizar (modo assíncrono), ou NULL para bloquear (modo síncrono).
fAsynchronousBOOLSe 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.

Relacionadas