Mit dem Aufruf Extract_Partner_LU_Name_Ex (CMEPLNX) erhält ein Programm den aktuellen partner_LU_name der Conversation in voller Länge.
Dieser Aufruf gehört zu den Advanced Functions.
Hinweis
Der Aufruf Extract_Partner_LU_Name gibt maximal 32 Bytes lange Namen zurück.
CMEPLNX (conversation_ID, partner_LU_name, requested_length, partner_LU_name_length, return_code)
Parameter
--> conversation_ID | Identifikation der Conversation. |
<-- partner_LU_name | Gibt den partner_LU_name zurück. |
--> requested_length | Maximale Länge von partner_LU_name, der empfangen werden kann. |
<-- partner_LU_name_length | Gibt die Länge des in partner_LU_name gelieferten Wertes an. Minimum: 1, Maximum: 73. |
<-- return_code | Ergebnis des Funktionsaufrufes. |
Ergebnis ( return_code )
CM_OK
Aufruf OK
CM_PROGRAM_PARAMETER_CHECK
Der Wert in conversation_ID ist ungültig oder requested_length ist nicht groß genug, um den partner_LU_name zu empfangen.
CM_PRODUCT_SPECIFIC_ERROR
Die UPIC-Instanz konnte nicht gefunden werden.
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.
CM_ENTRY Extract_Partner_LU_Name_Ex (unsigned char CM_PTR conversation_ID,
unsigned char CM_PTR partner_LU_name,
CM_INT32 CM_PTR requested_length,
CM_INT32 CM_PTR partner_LU_name_length,
CM_RETURN_CODE CM_PTR return_code)