Compartir a través de

Convert_Incoming (CPI-C)

  • Artículo

La llamada Convert_Incoming (nombre de función cmcnvi) convierte una cadena de caracteres EBCDIC en ASCII. Tenga en cuenta que la conversión de devolución se puede realizar mediante Convert_Outgoing.

Sintaxis

  
CM_ENTRY Convert_Incoming(   
  unsigned char FAR *string,    
  CM_INT32 FAR *string_length,  
  CM_INT32 FAR *return_code   
);

Parámetros

string
Parámetro proporcionado. Especifica la cadena EBCDIC que se va a convertir. La cadena puede contener cualquiera de los siguientes caracteres:

  • Mayúsculas A-Z

  • Minúscula a-z

  • Números de 0 a 9

  • El punto (.)

  • Caracteres de espacio

  • Los caracteres <> especiales + - ( ) & * ; : , ' ? / _= ".

    string_length caracteres de esta cadena se reemplazarán por equivalentes ASCII.

    string_length
    Parámetro proporcionado. Especifica el número de caracteres que se van a convertir (1–32767).

    return_code
    Código devuelto de esta llamada. Los códigos de retorno válidos se enumeran más adelante en este tema.

Códigos de retorno

CM_OK
Código de retorno principal; la llamada se ejecutó correctamente y el parámetro string contiene ahora la cadena ASCII convertida.

CM_OPERATION_NOT_ACCEPTED
Código de retorno principal; el parámetro string_length especificó un valor no válido.

CM_PRODUCT_SPECIFIC_ERROR
Código de retorno principal; se produjo un error específico del producto y se ha registrado en el registro de errores de productos.

Cambios de estado

La conversación puede estar en cualquier estado.

No hay ningún cambio de estado.

Comentarios

Cuando los datos se reciben en formato de búfer en una conversación básica, el búfer de datos puede contener varios registros lógicos, cada uno de los cuales consta de un campo de longitud de 2 bytes (NN) seguido de los datos. La aplicación debe extraer y convertir cada cadena de datos por separado (excepto el valor del campo de longitud). Las aplicaciones no deben intentar convertir todo el búfer en una operación, ya que esto hará que los valores de campo de longitud no sean válidos.