rpc_ns_mgmt_handle_set_exp_age- sets the expiration age for cached copies of name service data obtained with a given handle
void rpc_ns_mgmt_handle_set_exp_age( rpc_ns_handle_t ns_handle, unsigned32 expiration_age, unsigned32 *status);
- Specifies the name service handle for which the application supplies an expiration age.
- Specifies the expiration age, in seconds, for cached copies of name service data obtained with ns_handle.
- 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:
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
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.
- 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.
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.