NAME

rpc_ns_mgmt_read_codesets- reads the code sets attribute associated with a server entry in the name service database

SYNOPSIS

#include <dce/rpc.h>

void rpc_ns_mgmt_read_codesets(
	unsigned32 entry_name_syntax,
	unsigned_char_t *entry_name,
	rpc_codeset_mgmt_p_t *code_sets_array,
	error_status_t *status);

PARAMETERS

Input

entry_name_syntax

An integer value that specifies the syntax of the entry_name argument. To use the syntax that is specified in the RPC_DEFAULT_ENTRY_SYNTAX environment variable, specify rpc_c_ns_syntax_default.

entry_name

Specifies the name of the server entry in the name service database from which to read the code sets attribute. The name can be either the global or cell-relative name.

Output

code_sets_array

An integer array that specifies the code sets supported by the server. Each array element is an integer value that uniquely identifies one code set.

status

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

Possible status codes and their meanings include:

rpc_s_ok

Success.

rpc_s_name_service_unavailable

The routine was unable to communicate with the name service.

rpc_s_incomplete_name

The name specified in the call cannot be expanded.

rpc_s_invalid_name_syntax

The name syntax specified in the call is not valid.

rpc_s_entry_not_found

The specified name service entry was not found.

rpc_s_no_memory

The routine was unable to allocate memory to encode the value.

rpc_s_no_ns_permission

The routine's caller does not have the proper permission for an NSI operation.

DESCRIPTION

The rpc_ns_mgmt_read_codesets() routine retrieves a server's supported code sets by reading the code sets attribute associated with the server's entry in the name service database, allowing a client to evaluate them against its own supported code sets. The routine is one of those used for character and code set interoperability, which permits clients and servers to transfer international character data in a heterogeneous character set and code sets environment.

Client applications that use the code set evaluation routines rpc_cs_eval_with_universal() and rpc_cs_eval_without_universal() do not need to call the rpc_ns_mgmt_read_codesets() routine explicitly, because these routines call it on the client's behalf. Further character and code set evaluation implementations may need to make use of the rpc_ns_mgmt_read_codesets() routine.

Permissions Required

You need read permission to the target server entry in the name service.

RETURN VALUE

None.

SEE ALSO

rpc_ns_mgmt_free_codesets()
rpc_ns_mgmt_remove_attribute()
rpc_ns_mgmt_set_attribute()
rpc_rgy_get_codesets()
rpc_rgy_get_max_bytes().

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.