Der Aufruf Set_Partner_Host_Name (CMSPHN) setzt den Wert für die Characteristic HOSTNAME der Partner-Anwendung der Conversation. Der Aufruf überschreibt den Wert, der beim Initialize_Conversation-Aufruf zugewiesen wurde. Er darf nach dem Aufruf Allocate nicht mehr aufgerufen werden.
Diese Funktion gehört zu den zusätzlichen Funktionen des Trägersystems UPIC; sie ist nicht Bestandteil der CPI-C-Schnittstelle.
UPIC-Local auf Unix-, Linux- und Windows-Systemen:
Der Aufruf Set_Partner_Host_Name wird bei der Anbindung über UPIC-L nicht unterstützt.
UPIC-R mit openUTM-Cluster-Nutzung:
Der Aufruf Set_Partner_Host_Name wird nicht unterstützt, wenn ein openUTM-Cluster konfiguriert ist.
CMSPHN (conversation_ID, host_name, host_name_length, return_code)
Parameter
--> conversation_ID | Identifikation der Conversation |
--> host_name | legt fest, welcher Hostname verwendet wird |
--> host_name_length | legt die Länge des host_name in Byte fest. Minimum:1, Maximum:64 |
<-- return_code | Ergebnis des Funktionsaufrufs |
Ergebnis ( return_code )
CM_OK
Aufruf ok
CM_CALL_NOT_SUPPORTED
Dieser Returncode gilt nur für Unix-, Linux- und Windows-Systeme.
Die Funktion wird nicht unterstützt.
Bei UPIC-L tritt der Returncode immer auf. Er zeigt dem Programm an, dass kein host_name verwendet werden kann, da UPIC-L diese Information auf Grund des darunterliegenden Kommunikationssystems nicht benötigt.
Bei UPIC-R tritt der Returncode nur auf, wenn ein openUTM-Cluster konfiguriert wurde. Er zeigt dem Programm an, dass host_name nicht geändert werden kann.
CM_PROGRAM_PARAMETER_CHECK
Der Wert der conversation_ID oder für host_name_length ist ungültig.
CM_PROGRAM_STATE_CHECK
Die Conversation ist nicht im Zustand "Initialize".
CM_PRODUCT_SPECIFIC_ERROR
Die UPIC-Instanz konnte nicht gefunden werden.
Zustandsänderung
Der Aufruf ändert den Zustand der Conversation nicht.
Hinweis
Der Wert von host_name wird ignoriert, wenn auch für ip_adress ein Wert gesetzt ist, entweder in der upicfile oder durch einen Set_Partner_IP_Adress-Aufruf im UPIC-Programm.
Verhalten im Fehlerfall
CM_PROGRAM_PARAMETER_CHECK
Programm ändern.
CM_PROGRAM_STATE_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_CALL_NOT_SUPPORTED
Dieser Returncode gilt nur für Unix-, Linux- und Windows-Systeme.
Muss kein Fehler sein: Das Programm kann sich diesen Returncode merken und auf weitere Aufrufe zum Setzen von Adressinformationen verzichten.
CM_ENTRY Set_Partner_Host_Name( unsigned char CM_PTR conversation_ID,
unsigned char CM_PTR host_name,
CM_INT32 CM_PTR host_name_lth,
CM_RETURN_CODE CM_PTR return_code )