WinRUI
La funzione WinRUI fornisce una notifica asincrona dei messaggi per tutti i verbi RUI (Request Unit Interface) basati su Microsoft® Windows®.
Sintassi
int WINAPI WinRUI(
HWND hWnd,
LUA_VERB_RECORD FAR *lpVCB
);
Parametri
hWnd
Handle della finestra per la ricezione del messaggio.
lpVCB
Puntatore al blocco di controllo verbo (LUA) dell'applicazione unità logica (VCB), LUA_VERB_RECORD.
Valore restituito
La funzione restituisce un valore che indica se la richiesta è stata accettata dall'URI basata su Windows per l'elaborazione. Un valore restituito pari a zero indica che la richiesta è stata accettata e verrà elaborata. Un valore diverso da zero indica un errore. I codici di errore possibili sono i seguenti:
WLUAINVALIDHANDLE
L'handle di finestra specificato non è valido.
WLUASTARTUPNOTCALLED
L'applicazione non ha avviato una sessione usando WinRUIStartup.
Il valore restituito in lua_flag2.async indica se si verificherà una notifica asincrona. Se il flag è impostato (diverso da zero), si verificherà una notifica asincrona tramite un messaggio inviato alla coda dei messaggi delle applicazioni. Se il flag non è impostato, la richiesta è stata completata in modo sincrono. Esaminare il codice restituito primario e il codice restituito secondario per individuare eventuali condizioni di errore.
Commenti
Al termine dell'operazione asincrona, la finestra delle applicazioni hWnd riceve il messaggio restituito da RegisterWindowMessage con "WinRUI" come stringa di input. L'argomento lParam contiene l'indirizzo del vcb inviato come completato. L'argomento wParam non è definito.
Nota
È possibile che la richiesta venga accettata per l'elaborazione (la chiamata di funzione restituisce zero), ma rifiutata in seguito con un codice restituito primario e un codice restituito secondario impostato in VCB. Esaminare il codice restituito primario e il codice restituito secondario per individuare eventuali condizioni di errore.
Se l'applicazione chiama WinRUI senza prima inizializzare la sessione usando WinRUIStartup, viene restituito un errore.