Previous section.

CDE 1.1: Remote Procedure Call
Copyright © 1997 The Open Group

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.

Contents Next section Index