Condividi tramite

Set_TP_Name (CPI-C)

  • Articolo

La chiamata Set_TP_Name (nome funzione cmstpn) viene emessa dal programma di chiamata per specificare il nome del programma partner (richiamabile). Questa chiamata esegue l'override del nome del programma partner derivato dalle informazioni sul lato quando è stata emessa la chiamata Initialize_Conversation . Questa chiamata non può essere emessa dopo l'emissione della chiamata Allocata . L'emissione di questa chiamata non ha alcun effetto sulle informazioni sul lato stesso.

Sintassi

  
CM_ENTRY Set_TP_Name(   
  unsigned char FAR *conversation_ID,    
    unsigned char FAR *TP_name,            
    CM_INT32 FAR *TP_name_length,          
  CM_INT32 FAR *return_code              
);

Parametri

conversation_ID
Parametro fornito. Specifica l'identificatore per la conversazione. Il valore di questo parametro è stato restituito da Initialize_Conversation.

Tp_name
Parametro fornito. Specifica l'indirizzo iniziale del nome del programma partner. Il nome del programma può contenere fino a 64 caratteri ASCII. I caratteri consentiti sono:

  • Lettere maiuscole e minuscole.

  • Numeri da 0 a 9.

  • Caratteri speciali, ad eccezione dello spazio.

    Non è possibile usare Set_TP_Name per specificare il nome di un programma di transazione del servizio SNA (TP). È tuttavia possibile usare Set_CPIC_Side_Information per eseguire questa operazione.

    I set di caratteri a byte doppio, ad esempio Kanji, non sono supportati.

    TP_name_length
    Parametro fornito. Specifica la lunghezza del nome del programma partner. L'intervallo è compreso tra 1 e 64.

    return_code
    Codice restituito da questa chiamata. I codici restituiti validi sono elencati più avanti in questo argomento.

Codici restituiti

CM_OK
Codice restituito primario; la chiamata eseguita correttamente.

CM_PROGRAM_STATE_CHECK
Codice restituito primario; la conversazione non è in stato INITIALIZE.

CM_PROGRAM_PARAMETER_CHECK
Codice restituito primario; si è verificato uno dei seguenti:

  • Il valore specificato da conversation_ID non è valido.

  • Il valore specificato da TP_name_length non è compreso nell'intervallo (maggiore di 64 o minore di 1).

  • L'indirizzo di una variabile non è valido.

    CM_PRODUCT_SPECIFIC_ERROR
    Codice restituito primario; si è verificato un errore specifico del prodotto ed è stato registrato nel log degli errori dei prodotti.

Modifiche di stato

La conversazione deve essere in stato INITIALIZE.

Non esiste alcuna modifica dello stato.