dced_list_get(3dce)Returns the list of data entries maintained by a dced service on a specific host Synopsis #include <dce/dced.h> void dced_list_get( dced_binding_handle_t dced_bh, dced_entry_list_t *list, error_status_t *status); Parameters Input
dced_bh Output
list
status
Description If a service's entry list is small, it may be efficient to obtain the entire list using the dced_list_get( ) routine because it guarantees the list is obtained with one remote procedure call. However, to make your application scaleable, use the dced_initialize_cursor( ), dced_entry_get_next( ), and dced_release_cursor( ) set of routines because if an entry list is very large, it may be more efficient (or even necessary) to obtain the list in chunks with more than one remote procedure call. Prior to calling this routine, the application must have established a valid dced binding handle by calling either the dced_binding_create( ) or dced_binding_from_rpc_binding( ) routine.
Examples
dced_binding_from_rpc_binding(service_type, rpc_bh, &dced_bh, &status); 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. error_status_ok dced_s_bad_binding dced_s_no_memory dced_s_no_support sec_acl_invalid_permission
Related Information dced_binding_from_rpc_binding(3dce) Book: OSF DCE Application Development Guide - Core Components
|