PreviousNext

idl_es_inq_encoding_id(3rpc)

Identifies an operation within an interface that has been called to encode data using the IDL encoding services

Synopsis

void idl_es_inq_encoding_id(

idl_es_handle_t es_handle,

rpc_if_id_t *if_id,

idl_ulong_int *op_num,

error_status_t *status);

Parameters

Input

es_handle
A encoding services handle returned by one of the IDL encoding services handle-returning routines.

Output

if_id
Returns the interface UUID and version number assigned to the interface that defines the operation that encoded the data. This information is stored in the IDL encoding services handle that is associated with the encoded data.

op_num
Returns the operation number assigned to the operation that encoded the data. Operations are numbered in the order in which they appear in the interface definition, starting with zero (0). The operation number for the operation that encoded the data is stored in the IDL encoding services handle that is associated with the encoded data.

status
Returns the status code from this routine. This status code indicates whether the routine completed successfully or, if not, why not.

Description
The IDL encoding services provide client and server RPC applications with a method for encoding data types in input parameters into a byte stream and decoding data types in output parameters from a byte stream without invoking the RPC runtime. Encoding and decoding operations are analogous to marshalling and unmarshalling, except that the data is stored locally, and is not transmitted over the network. Client and server applications can use the IDL encoding services to create persistent storage for their data. Encoding "flattens" complex data types into a byte stream for storage on disk, while decoding restores the flattened data to complex form.

The idl_es_inq_encoding_id( ) routine returns the identity of an operation within an application that has been invoked to encode data using the IDL encoding services. Applications can use this routine to determine the identity of an encoding operation, for example, before calling their decoding operations.

Return Values
None.

Errors

The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

rpc_s_ok
Success.

rpc_s_unknown_if
Interface identifier and operation number unavailable.

Related Information
Functions: idl_es_decode_buffer(3rpc)

idl_es_decode_incremental(3rpc)

idl_es_encode_dyn_buffer(3rpc)

idl_es_encode_fixed_buffer(3rpc)

idl_es_encode_incremental(3rpc)