Freigeben über


Empfangen von Daten

Mit den folgenden Aufrufen oder Erweiterungen kann ein Programm Daten aus dem Partnerprogramm empfangen:

Hinweis

Die Namen der Anrufe sind Pseudonyme. Die tatsächlichen C-Funktionsnamen werden nach den Pseudonymen in Klammern angezeigt. Beispielsweise ist Accept_Conversation das Pseudonym für einen Anruf. Der tatsächliche Funktionsname ist cmaccp.

Empfangen( cmrcv)
Wenn Sie diesen Anruf ausgeben, während sich die Unterhaltung im RECEIVE-Zustand befindet, empfängt das lokale Programm alle Daten, die derzeit im Partnerprogramm verfügbar sind. Wenn keine Daten verfügbar sind und der Empfangstyp auf CM_RECEIVE _AND_WAIT festgelegt ist, wartet das lokale Programm auf das Eintreffen von Daten. Wenn der Empfangstyp auf CM_RECEIVE_IMMEDIATE festgelegt ist, wartet das Programm nicht.

Das Ausstellen dieses Anrufs, während sich die Unterhaltung im SEND- oder SEND_PENDING-Zustand befindet, ist nur zulässig, wenn der Empfangstyp auf CM_RECEIVE_AND_WAIT festgelegt ist. Dadurch wird der Sendepuffer der logischen Einheit (LU) geleert und der Kommunikationsstatus auf RECEIVE gesetzt. Das lokale Programm beginnt dann mit dem Empfangen von Daten.

Set_Fill( cmsf)
Wird in einer einfachen Unterhaltung verwendet, legt dieser Anruf den Fülltyp der Unterhaltung fest, der angibt, ob Programme Daten in Form von logischen Datensätzen oder als angegebene Datenlänge empfangen. Dieser Anruf hat nur Auswirkungen auf grundlegende Gespräche. Der Füllwert wirkt sich auf alle nachfolgenden Empfangsanrufe aus . Sie kann geändert werden, indem Set_Fill erneut ausgegeben wird.

Set_Processing_Mode( cmspm)
Gibt für die Unterhaltung an, ob nachfolgende Aufrufe zurückgegeben werden, wenn der angeforderte Vorgang abgeschlossen ist (Blockieren) oder unmittelbar nach dem Initiieren des Vorgangs (nicht blockierend). Ein Programm wird über den Abschluss von nicht blockierenden Aufrufen benachrichtigt, wenn es Wait_For_Conversation ausgibt oder durch eine Microsoft Windows-Nachricht, die an einen WndProc gesendet wird, der über den hwndNotify-Parameter in Specify_Windows_Handle identifiziert wird.

Set_Receive_Type( cmsrt)
Legt den Empfangstyp des Gesprächs fest, der angibt, ob ein Programm, das einen Receive-Aufruf ausgibt, auf Daten wartet, wenn keine Daten verfügbar sind. Der Empfangstypwert wirkt sich auf alle nachfolgenden Empfangsanrufe aus . Sie kann geändert werden, indem sie Set_Receive_Type erneut angibt.

Specify_Windows_Handle( xchwnd)
Legt das Fenster-Handle fest, an das eine Nachricht nach Abschluss eines Vorgangs im nicht-blockierenden Modus gesendet wird. Eine Anwendung kann den Verarbeitungsmodus durch Aufrufen von Set_Processing_Mode festlegen. Wenn das Fensterhandle 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.