WinSLI
La fonction WinSLI fournit une notification de message asynchrone pour tous les verbes SLI (Session Level Interface) basés sur Microsoft® Windows®.
Syntaxe
int WINAPI WinSLI(
HWND hWnd,
LUA_VERB_RECORD FAR *lpVCB );
Paramètres
hWnd
Gérer la fenêtre pour recevoir le message.
lpVCB
Pointeur vers le bloc de contrôle de verbe (VCB) de l’application d’unité logique (LUA), LUA_VERB_RECORD.
Valeur renvoyée
La fonction retourne une valeur indiquant si la demande a été acceptée par le SLI windows pour traitement. Une valeur renvoyée de zéro indique que la demande a été acceptée et sera traitée. Une valeur autre que zéro indique une erreur. Les codes d’erreur possibles sont les suivants :
WLUAINVALIDHANDLE
Le handle de fenêtre fourni n’est pas valide.
WLUASTARTUPNOTCALLED
L’application n’a pas lancé de session à l’aide de WinSLIStartup.
La valeur retournée dans lua_flag2.async indique si une notification asynchrone se produira. Si l’indicateur est défini (différent de zéro), une notification asynchrone se produit via un message publié dans la file d’attente des messages des applications. Si l’indicateur n’est pas défini, la demande s’est terminée de manière synchrone. Examinez le code de retour principal et le code de retour secondaire pour rechercher des conditions d’erreur.
Remarques
Une fois l’opération asynchrone terminée, la fenêtre d’applications hWnd reçoit le message retourné par RegisterWindowMessage avec « WinSLI » comme chaîne d’entrée. L’argument lParam contient l’adresse du VCB en cours de publication comme complet. L’argument wParam n’est pas défini.
Notes
Il est possible que la demande soit acceptée pour traitement (l’appel de fonction retourne zéro), mais rejetée ultérieurement avec un code de retour principal et un code de retour secondaire défini dans le VCB. Examinez le code de retour principal et le code de retour secondaire pour rechercher des conditions d’erreur.
Si l’application appelle WinSLI sans initialiser la session à l’aide de WinSLIStartup, une erreur est retournée.