Name

dced_object_read_all - Reads all the data for a service of dced on specific host

Synopsis

#include <dce/dced.h> void dced_object_read_all(
dced_binding_handle_t dced_bh,
unsigned32 ∗count,
void ∗∗data_list,
error_status_t ∗status);

Parameters

Input

dced_bhSpecifies the dced binding handle for a dced service on a specific host. 

Output

countReturns the count of the number of data items read. 

data_listReturns the list of data items read.  The data returned is an array of one of the following types, depending on the service:

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

Description

The dced_object_read_all() routine reads all the data for a specified host service on a specific host.  When the application is done with the data, it should call the dced_objects_release() routine.  Applications can also read individual data objects for a service using the dced_object_read() routine. 

The valid services for which you can read data include hostdata, srvrconf, srvrexec, and keytab. 

Prior to calling the dced_object_read_all() 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

The following example reads and displays all the data for a particular dced service. 

dced_binding_handle_t   dced_bh;
dced_string_t           host_service;
void                    ∗data_list;
unsigned32              count;
error_status_t          status;
 dced_binding_create(host_service, dced_c_binding_syntax_default, &dced_bh, &status);
dced_object_read_all(dced_bh, &count, &data_list, &status);
display(host_service, count, &data_list); /∗ application specific ∗/
dced_objects_release(dced_bh, count, data_list, &status);
dced_binding_free( 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

db_s_bad_index_type

db_s_key_not_found

dce_cf_e_file_open

dce_cf_e_no_match

dce_cf_e_no_mem

dced_s_bad_binding

dced_s_need_privacy

dced_s_no_memory

dced_s_no_support

dced_s_not_found

rpc_s_binding_has_no_auth

rpc_s_invalid_binding

rpc_s_wrong_kind_of_binding

sec_acl_invalid_permission

sec_key_mgmt_e_authn_invalid

sec_key_mgmt_e_key_unavailable

sec_key_mgmt_e_unauthorized

sec_s_no_memory

uuid_s_bad_version

Related Information

Functions: dced_binding_create(3dce), dced_binding_from_rpc_binding(3dce), dced_object_read(3dce), dced_objects_release(3dce). 

Books: OSF DCE Application Development Guide.