rpc_ns_entry_object_inq_next(3rpc)Returns one object at a time from an entry in the name service database Used by client, server, or management applications. Synopsis #include <dce/rpc.h> void rpc_ns_entry_object_inq_next( rpc_ns_handle_t inquiry_context, uuid_t *obj_uuid, unsigned32 *status); Parameters Input
inquiry_context Output
obj_uuid
status
Description An application can view all of the exported object UUIDs by repeatedly calling the rpc_ns_entry_object_inq_next( ) routine. When all the object UUIDs are viewed, this routine returns an rpc_s_no_more_members status. The returned object UUIDs are unordered. The application supplies the memory for the object UUID returned in the obj_uuid parameter. After viewing the object UUIDs, the application must call the rpc_ns_entry_object_inq_done( ) routine to delete the inquiry context. The order in which rpc_ns_entry_object_inq_next( ) returns object UUIDs can be different for each viewing of an entry. Therefore, the order in which an application receives object UUIDs can be different each time the application is run.
Permissions Required
Return Values 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.
rpc_s_ok
rpc_s_class_version_mismatch
rpc_s_entry_not_found
rpc_s_incomplete_name
rpc_s_invalid_ns_handle
rpc_s_name_service_unavailable
rpc_s_no_more_members
rpc_s_no_ns_permission
rpc_s_not_rpc_entry
Related Information rpc_ns_entry_object_inq_begin(3rpc) rpc_ns_entry_object_inq_done(3rpc)
|