Extract_Partner_LU_Name - partner_LU_Name abfragen

Mit dem Aufruf Extract_Partner_LU_Name (CMEPLN) erhält ein Programm den aktuellen partner_LU_name der Conversation.

Dieser Aufruf gehört zu den Advanced Functions.

Syntax

CMEPLN(conversation_ID, partner_LU_name, partner_LU_name_length, return_code)

Parameter

--> conversation_ID	Identifikation der Conversation.
<-- partner_LU_name	Gibt den partner_LU_name zurück. Die Länge des Parameters muss mindestens 32 Byte sein.
<-- partner_LU_name_length	Gibt die Länge des in partner_LU_name gelieferten Wertes an. Minimum: 1, Maximum: 32.
<-- return_code	Ergebnis des Funktionsaufrufes.

Ergebnis (return_code)

CM_OK

Aufruf OK

CM_PROGRAM_PARAMETER_CHECK

Der Wert in conversation_ID ist ungültig.

CM_PRODUCT_SPECIFIC_ERROR

Die UPIC-Instanz konnte nicht gefunden werden (Interner Fehler).

CM_PROGRAM_STATE_CHECK

Die Conversation ist nicht im Zustand „Initialize“.

Zustandsänderung

Der Aufruf ändert den Zustand der Conversation nicht.

Hinweis

• Falls der Returncode von CM_OK verschieden ist, hat der Wert von partner_LU_name keine Bedeutung.

Verhalten im Fehlerfall

CM_PROGRAM_PARAMETER_CHECK

Programm ändern.

CM_PRODUCT_SPECIFIC_ERROR

Das Betriebssystem kann nicht genügend Speicherplatz für interne Puffer bereitstellen. Überprüfen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf. Ihr System neu.

CM_PROGRAM_STATE_CHECK

Programm ändern.

Funktionsdeklaration: Extract_Partner_LU_Name

CM_ENTRY Extract_Partner_LU_Name (unsigned char  CM_PTR conversation_ID,
                                  unsigned char  CM_PTR partner_LU_name,
                                  CM_INT32       CM_PTR partner_LU_name_length,
                                  CM_RETURN_CODE CM_PTR return_code)