Paramètres de retour

Cette fonction renvoie une chaîne de données et un code retour.

Chaîne de données :: Si A (asynchrone) est spécifié en position 5 (2 pour l'interface standard) et que la fonction s'exécute avec succès, la chaîne de données suivante est renvoyée :


Octet		Définition
9–10	13–14	ID de demande de fonction sur 2 octets. Il est utilisé par la fonction Get Request Completion (125) pour déterminer l'achèvement de cet appel de fonction.
	15–16	Réservé.
	17–20	Valeur de 4 octets dans laquelle l'adresse de l'objet événement est renvoyée par EHLLAPI. L'application peut attendre cet objet événement. Lorsque l'objet événement est effacé, l'application doit émettre l'appel de fonction Get Request Completion (125) pour obtenir les résultats de la demande Write Structured Fields. (32 bits uniquement).

Note : Un objet événement est renvoyé pour chaque demande asynchrone réussie. L'objet événement ne doit plus être utilisé. Un nouvel objet événement est renvoyé pour chaque demande et n'est valide que pour la durée de cette demande.

Chaîne de données :: Si M (mode de message asynchrone) est spécifié en position 5 (2 pour l'interface standard) et que la fonction est terminée avec succès, la chaîne de données suivante est renvoyée :


Octet		Définition
9–10	13–14	ID de demande de fonction sur 2 octets. Il est utilisé par la fonction Get Request Completion (125) pour déterminer l'achèvement de cet appel de fonction.
9–10	15–16	Réservé.
11–12	17–18	ID de tâche du mode de message asynchrone.
11–12	19–20	Réservé.

Note : Si la fonction est terminée avec succès, une fenêtre d'application reçoit un message. Le message est une valeur de retour de RegisterWindowMessage (PCSHLL). Le paramètre wParam contient l'ID de tâche renvoyé par l'appel de fonction. HIWORD du paramètre lParam contient le code retour 0, qui indique que la fonction a réussi, et LOWORD du paramètre lParam contient le numéro de fonction 127.

Code retour :: Les codes suivants sont définis :


Code retour	Explication
0	La fonction Write Structured Fields a réussi.
1	Un ID de session court de l'espace de présentation hôte spécifié n'était pas valide ou n'était pas connecté.
2	Une erreur a été commise lors de la spécification des paramètres.
9	Une erreur système s'est produite.
11	Ressource non disponible (mémoire non disponible).
34	Le message envoyé à l'hôte a été annulé.
35	Une transmission sortante de l'hôte a été annulée.
36	Demande rejetée. Perte de contact avec l'hôte.
37	Echec. L'hôte est désactivé pour les communications entrantes.