Convert_Outgoing (CPI-C)

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

Sintaxis

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

Parámetros

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

  • Mayúsculas A-Z

  • Minúsculas a–z

  • Números del 0 al 9

  • El punto (.)

  • Caracteres de espacio

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

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

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

    return_code
    Código devuelto por 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 ahora contiene la cadena EBCDIC convertida.

CM_OPERATION_NOT_ACCEPTED
Código de retorno principal; el string_length parámetro 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 registró 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.

Observaciones

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 que consta de un campo de longitud de dos 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 son válidos.