Specify_Windows_Handle (CPI-C)

Artikel
10/14/2023

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

Syntax

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

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 Produktfehlerprotokoll protokolliert.

Zustandsänderungen

Die Zustandsänderung hängt vom abgeschlossenen Vorgang und dem Rückgabecode ab.

Hinweise

Eine Anwendung kann den Verarbeitungsmodus festlegen, indem sie Set_Processing_Mode aufruft. 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 Meldung mit "WinAsyncCPIC" als Eingabezeichenfolge. Der wParam-Wert enthält die conversation_return_code des abgeschlossenen Vorgangs. Die Werte hängen davon ab, welcher Vorgang ursprünglich ausgegeben wurde. Das Argument lParam enthält die CM_PTR für die im ursprünglichen Funktionsaufruf angegebene conversation_ID .

Freigeben über