Condividi tramite

Set_Conversation_Type (CPI-C)

  • Articolo

La chiamata Set_Conversation_Type (nome funzione cmsct) viene rilasciata dal programma di chiamata per definire una conversazione come mappata o di base. Questa chiamata esegue l'override del tipo di conversazione predefinito stabilito da Initialize_Conversation. Il tipo di conversazione predefinito è CM_MAPPED_CONVERSATION. Questa chiamata non può essere emessa dopo l'emissione dell'allocazione .

Sintassi

  
CM_ENTRY Set_Conversation_Type(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *conversation_type,    
    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.

conversation_type
Parametro fornito. Specifica il tipo di conversazione da allocare da Allocare. I valori possibili sono:

  • CM_BASIC_CONVERSATION

  • CM_MAPPED_CONVERSATION

    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 o conversation_type non è valido.

  • Il parametro conversation_type specifica una conversazione mappata, ma la caratteristica di riempimento è impostata su CM_FILL_BUFFER, che non è compatibile con le conversazioni mappate. Prima di modificare il tipo di conversazione in cui eseguire il mapping, è necessario eseguire la chiamata Set_Fill per modificare il tipo di riempimento in CM_FILL_LL .

  • Il parametro conversation_type specifica una conversazione mappata. Tuttavia, una chiamata precedente Set_Log_Data , consentita solo nelle conversazioni di base, è ancora in vigore.

    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.