Specify_Windows_Handle (CPI-C)

L’appel de Specify_Windows_Handle (nom de la fonction xchwnd) définit le handle Microsoft® Windows® auquel un message est envoyé à la fin d’une opération en mode non bloquant.

Syntaxe

  
CM_ENTRY Specify_Windows_Handle(   
  HWND hwndNotify,             
  CM_INT32 FAR *return_code    
);  

Paramètres

hwndNotify
Paramètre fourni. Spécifie le handle Windows à notifier lorsque l’opération en attente se termine.

return_code
Code retourné par cet appel. Les codes de retour valides sont répertoriés plus loin dans cette rubrique.

Codes de retour

CM_OK
Code de retour principal ; l’appel a été exécuté avec succès.

CM_PROGRAM_PARAMETER_CHECK
Le handle Windows n’est pas valide.

CM_PRODUCT_SPECIFIC_ERROR
Code de retour principal ; une erreur spécifique au produit s’est produite et a été enregistrée dans le journal des erreurs des produits.

Changements d'état

Le changement d’état dépend de l’opération qui s’est terminée et de son code de retour.

Remarques

Une application peut définir le mode de traitement en appelant Set_Processing_Mode. Si le handle Windows est défini sur NULL, ou si cet appel n’est jamais émis, l’application doit appeler Wait_For_Conversation pour être avertie lorsque l’opération en suspens se termine.

Lorsqu’une opération asynchrone est terminée, la fenêtre d’applications hwndNotify reçoit le message retourné par RegisterWindowMessage avec « WinAsyncCPIC » comme chaîne d’entrée. La valeur wParam contient les conversation_return_code de l’opération qui se termine. Ses valeurs dépendent de l’opération qui a été émise à l’origine. L’argument lParam contient les CM_PTR à la conversation_ID spécifiée dans l’appel de fonction d’origine.