NAME

rpc_ns_mgmt_handle_set_exp_age- sets the expiration age for cached copies of name service data obtained with a given handle

SYNOPSIS

#include <dce/rpc.h>

void rpc_ns_mgmt_handle_set_exp_age(
	rpc_ns_handle_t ns_handle,
	unsigned32 expiration_age,
	unsigned32 *status);

PARAMETERS

Input

ns_handle

Specifies the name service handle for which the application supplies an expiration age.

expiration_age

Specifies the expiration age, in seconds, for cached copies of name service data obtained with ns_handle.

Output

status

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

Possible status codes and their meanings include:

rpc_s_ok

Success.

DESCRIPTION

The rpc_ns_mgmt_handle_set_exp_age() routine sets the expiration age for the specified name service handle, ns_handle. This expiration age is used, instead of the application's global expiration age, for all name service operations obtained using ns_handle. Expiration age is further described in tagmref_rpc_ns_mgmt_inq_exp_age .

Because name service caching is implementation-dependent, the effect of setting a handle's expiration age (on subsequent name service operations performed with the handle) is implementation dependent.

Note:

In implementations that perform name service caching, setting the handle expiration age to a small value may cause operations that retrieve data from the name service to update cached data frequently. An expiration age of 0 (zero) forces an update on each operation involving the same attribute data. Frequent updates may adversely affect the performance both of the calling application and any other applications that share the same cache.

Permissions Required

None.

RETURN VALUE

None.

SEE ALSO

rpc_ns_binding_import_begin()
rpc_ns_binding_lookup_begin()
rpc_ns_entry_object_inq_begin()
rpc_ns_group_mbr_inq_begin()
rpc_ns_mgmt_inq_exp_age()
rpc_ns_mgmt_set_exp_age()
rpc_ns_profile_elt_inq_begin().

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.