Specify_Windows_Handle (CPI-C)

Der Specify_Windows_Handle Aufruf (Funktionsname xchwnd) legt das Microsoft® Windows-Handle® fest, an das eine Nachricht nach Abschluss eines Vorgangs im Nichtblockingmodus gesendet wird.

Syntax

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

Die Parameter

hwndNotify
Angegebener Parameter. Gibt das Windows-Handle an, das benachrichtigt werden soll, wenn der ausstehende Vorgang abgeschlossen ist.

return_code
Der von diesem Aufruf zurückgegebene Code. Die gültigen Rückgabecodes werden weiter unten in diesem Thema aufgeführt.

Rückgabecodes

CM_OK
Primärer Rückgabecode; Der Aufruf wurde erfolgreich ausgeführt.

CM_PROGRAM_PARAMETER_CHECK
Das Windows-Handle ist ungültig.

CM_PRODUCT_SPECIFIC_ERROR
Primärer Rückgabecode; Ein produktspezifischer Fehler ist aufgetreten und wurde im Fehlerprotokoll der Produkte protokolliert.

Statusänderungen

Die Statusänderung hängt von dem abgeschlossenen Vorgang und dem Rückgabecode ab.

Bemerkungen

Eine Anwendung kann den Verarbeitungsmodus durch Aufrufen von Set_Processing_Mode festlegen. Wenn das Windows-Handle auf NULL festgelegt ist oder dieser Aufruf nie ausgegeben wird, muss die Anwendung Wait_For_Conversation aufrufen, um benachrichtigt zu werden, wenn der ausstehende Vorgang abgeschlossen ist.

Wenn ein asynchroner Vorgang abgeschlossen ist, empfängt das Anwendungsfenster hwndNotify die von RegisterWindowMessage zurückgegebene Nachricht mit "WinAsyncCPIC" als Eingabezeichenfolge. Der wParam-Wert enthält die conversation_return_code aus dem vorgang, der abgeschlossen wird. Die Werte hängen davon ab, welcher Vorgang ursprünglich ausgestellt wurde. Das Argument "lParam " enthält die CM_PTR zu den im ursprünglichen Funktionsaufruf angegebenen conversation_ID .