Specify_Windows_Handle (CPI-C)

L’appel Specify_Windows_Handle (nom de fonction xchwnd) définit le handle Microsoft® Windows® auquel un message est envoyé à l’achèvement 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 à avertir lorsque l’opération en attente se termine.

return_code
Code retourné à partir de 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.

Modifications 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 attente se termine.

Lorsqu’une opération asynchrone est terminée, la fenêtre des applications hwndNotify reçoit le message retourné par RegisterWindowMessage avec « WinAsyncCPIC » comme chaîne d’entrée. La valeur wParam contient la 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 l’CM_PTR au conversation_ID spécifié dans l’appel de fonction d’origine.