dced_object_read

dced_object_read_all(3dce)

Reads all the data for a service of the DCE Host daemon (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_bh
Specifies the dced binding handle for a dced service on a specific host.

Output

count
Returns the count of the number of data items read.

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

Service Data Type of Array Returned
hostdata sec_attr_t
srvrconf server_t
srvrexec server_t
keytab dced_key_list_t

status
Returns 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