Funzione RegisterGPNotification (userenv.h)
La funzione RegisterGPNotification consente a un'applicazione di ricevere una notifica quando si verifica una modifica dei criteri. Quando si verifica una modifica dei criteri, l'oggetto evento specificato viene impostato sullo stato segnalato.
Sintassi
USERENVAPI BOOL RegisterGPNotification(
[in] HANDLE hEvent,
[in] BOOL bMachine
);
Parametri
[in] hEvent
Handle per un oggetto evento. Utilizzare la funzione CreateEvent per creare l'oggetto evento.
[in] bMachine
Specifica il tipo di modifica dei criteri. Se TRUE, vengono segnalate modifiche ai criteri computer. Se FALSE, vengono segnalate modifiche ai criteri utente.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Chiamare la funzione UnregisterGPNotification per annullare la registrazione dell'handle dalla ricezione delle notifiche di modifica dei criteri. Chiamare la funzione CloseHandle per chiudere l'handle quando non è più necessario.
Un'applicazione può anche ricevere notifiche sulle modifiche ai criteri quando viene trasmesso un messaggio WM_SETTINGCHANGE . In questa istanza, il valore del parametro wParam è 1 se è stato applicato il criterio computer; è zero se sono stati applicati i criteri utente. Il parametro lParam punta alla stringa "Policy".
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | userenv.h |
| Libreria | Userenv.lib |
| DLL | Userenv.dll |