atributo represent_as

El atributo ACF [represent_as] asocia un tipo local con nombre en el tipo repr-type de idioma de destino con un tipo de transferencia denominado tipo que se transfiere entre el cliente y el servidor.

typedef [represent_as(repr-type) [[ , type-attribute-list ]] ] named-type; 
void __RPC_USER named-type_from_local (
  repr-type __RPC_FAR * ,
  named-type __RPC_FAR * __RPC_FAR * );
void __RPC_USER named-type_to_local (
  named-type __RPC_FAR * ,
  repr-type __RPC_FAR * ); void __RPC_USER named-type _free_inst ( named-type __RPC_FAR * ); void __RPC_USER named-type _free_local ( repr-type __RPC_FAR * );

Parámetros

tipo con nombre

Especifica el tipo de datos de transferencia con nombre que se transfiere entre el cliente y el servidor.

type-attribute-list

Especifica uno o varios atributos que se aplican al tipo. Separe varios atributos con comas.

repr-type

Especifica el tipo local representado en el idioma de destino que se presenta a las aplicaciones cliente y servidor.

Comentarios

Al usar [represent_as], debe proporcionar rutinas que conviertan entre los tipos de transferencia locales y los tipos de transferencia y esa memoria libre usada para contener los datos convertidos. El atributo [represent_as] indica a los códigos auxiliares que llamen a las rutinas de conversión proporcionadas por el usuario.

El tipo transferido denominado-type debe resolverse en un tipo base MIDL, un tipo predefinido o un identificador de tipo. Para obtener más información, vea Tipos base MIDL.

Debe proporcionar las siguientes rutinas:

Nombre de rutina	Descripción
named_type**_from_local**	Convierte los datos del tipo local en el tipo de red. La rutina asigna memoria para el tipo de datos de red, incluida la memoria de los datos a los que hacen referencia los punteros del tipo de datos de red.
named_type**_to_local**	Convierte los datos del tipo de red en el tipo local. La rutina es responsable de asignar memoria para los datos a los que hacen referencia los punteros en el tipo local. RPC asigna memoria para el propio tipo local.
named_type**_free_local**	Libera memoria asignada para los datos a los que hacen referencia los punteros en el tipo local. RPC libera memoria para el propio tipo
named_type**_free_inst**	Libera memoria asignada para los datos a los que hacen referencia los punteros en el tipo de red y para el propio tipo de red.

 

El código auxiliar de cliente llama al tipo de cliente**_from_local** para asignar espacio para el tipo transmitido y traducir los datos del tipo local al tipo de red. El código auxiliar del servidor asigna espacio para el tipo de datos original y llama a named-type**_to_local** para traducir los datos del tipo de red al tipo local.

Tras devolver el código de la aplicación, los códigos auxiliares del cliente y del servidor llaman denominado-type**_free_inst** para desasignar el almacenamiento para el tipo de red. El código auxiliar de cliente llama al tipo de cliente**_free_local** para desasignar el almacenamiento devuelto por la rutina.

Los tipos siguientes no pueden tener un atributo [represent_as]:

• Matrices conformes, variables o conformes
• Estructuras en las que el último miembro es una matriz conforme (una estructura conforme)
• Punteros o tipos que contienen un puntero
• Canalizaciones o tipos que contienen canalizaciones
• Tipos que se usan como tipo base para una canalización
• Tipos predefinidos handle_t, void
• Tipos que tienen el atributo [handle]

Ejemplos

//these data types defined in .IDL or elsewhere
typedef struct  _lbox 
{ 
    long         data; 
    struct _lbox *next; 
} lbox; 
typedef [ref] lbox *PBOX_LOC; 
typedef long LONG4[4]; 
 
//in .ACF file :
interface iface
{
    typedef  [ represent_as(PBOX_LOC) ]  LONG4; 
}

Vea también

Archivo de configuración de la aplicación (ACF)

Matrices

Tipos base MIDL

handle_t

Typedef

Vacío