OSF DCE Application Development Guide--Core Components

ManualsBrandsHP ManualsServerHP NonStop G-Series

471

472

473

474

475

476

477

478

479

480

OSF DCE Application Development Guide—Core Components

ACF

interface es_array

{

[encode] in_array_op1();

[decode] out_array_op1();

[encode, decode] array_op2();

}

IDL File

[uuid(20aac780-5398-11c9-b996-08002b13d56d), version(0)]

interface es_array

{

void in_array_op1([in] handle_t h, [in] long arr[100]);

void out_array_op1([in] handle_t h, [out] long arr[100]);

void array_op2([in] handle_t h, [in,out] long big[100]);

void array_op3([in] handle_t h, [in,out] long big[100]);

}

18.3.14 The cs_char Attribute

The cs_char attribute is intended for use in internationalized RPC applications. It is

used in conjunction with the cs_stag, cs_drtag, cs_rtag and cs_tag_rtn attributes and

the DCE RPC routines for automatic code set conversion to provide RPC applications

with a mechanism for ensuring character and code set interoperability between clients

and servers transferring international (non-PCS) characters.

The cs_char attribute is very similar in function to the represent_as attribute, in that it

associates a local data type that your application code uses with a data type deﬁned in

the IDL ﬁle. The cs_char attribute permits the application code to use the local data

type for international character data and converts between the local data type and the

format speciﬁed in the IDL ﬁle when transferring international characters over the

network. The cs_char ACF attribute permits the conversion of characters, arrays of

characters, and strings of characters between the format in which the application code

requires them and the format in which they are transmitted over the network.

As with represent_as, use of the cs_char attribute means that, during marshalling and

unmarshalling, conversions occur between the data type that the application code is

using and the data type speciﬁed in IDL. In the case of cs_char, the local data type is

automatically converted between the local data type in the local code set encoding and

the idl_byte data type in the network code set encoding. The network code set is the

code set encoding that the application code, through the use of the DCE RPC automatic

code set conversion routines, has selected to use when transmitting the international

characters over the network.

18 − 20 Tandem Computers Incorporated 124245