Specify_Windows_Handle (CPI-C)

La chiamata Specify_Windows_Handle (nome funzione xchwnd) imposta l'handle di Microsoft® Windows® a cui viene inviato un messaggio al completamento di un'operazione in modalità non bloccante.

Sintassi

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

Parametri

hwndNotify
Parametro fornito. Specifica l'handle di Windows da notificare al termine dell'operazione in sospeso.

return_code
Codice restituito da questa chiamata. I codici restituiti validi sono elencati più avanti in questo argomento.

Codici restituiti

CM_OK
Codice restituito primario; la chiamata eseguita correttamente.

CM_PROGRAM_PARAMETER_CHECK
L'handle di Windows non è valido.

CM_PRODUCT_SPECIFIC_ERROR
Codice restituito primario; si è verificato un errore specifico del prodotto ed è stato registrato nel log degli errori dei prodotti.

Modifiche di stato

La modifica dello stato dipende dall'operazione completata e dal relativo codice restituito.

Commenti

Un'applicazione può impostare la modalità di elaborazione chiamando Set_Processing_Mode. Se l'handle di Windows è impostato su NULL o questa chiamata non viene mai eseguita, l'applicazione deve chiamare Wait_For_Conversation per ricevere una notifica al termine dell'operazione in sospeso.

Al termine di un'operazione asincrona, la finestra delle applicazioni hwndNotify riceve il messaggio restituito da RegisterWindowMessage con "WinAsyncCPIC" come stringa di input. Il valore wParam contiene il conversation_return_code dall'operazione completata. I relativi valori dipendono dall'operazione originariamente rilasciata. L'argomento lParam contiene il CM_PTR al conversation_ID specificato nella chiamata di funzione originale.