Name

dced_inq_id - Obtains the entry UUID that dced associates with a name

Synopsis

#include <dce/dced.h> void dced_inq_id(
dced_binding_handle_t dced_bh,
dced_string_t name,
uuid_t ∗uuid,
error_status_t ∗status);

Parameters

Input

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

nameSpecifies the name for which to obtain the uuid. 

Output

uuidreturns the UUID associated with the name input. 

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

Description

The dced_inq_id() routine obtains the UUID associated with a name in a service of a specific host’s dced.  Applications and administrators use strings maintained by dced to identify data, but dced and its API must associate each data entry with a UUID.  This routine is valid for the hostdata, srvrconf, srvrexec, and keytab services. 

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

The following example establishes a dced binding to a host’s server configuration service.  The example then obtains the UUID of some known server in order to read the server’s configuration data. 

dced_binding_handle_t dced_bh;
server_t              conf;
dced_string_t         server_name;
uuid_t                srvrconf_id;
error_status_t        status;
 dced_binding_create("srvrconf@hosts/patrick",
                    dced_c_binding_syntax_default,
                    &dced_bh,
                    &status);
dced_inq_id(dced_bh, server_name, &srvrconf_id, &status);
dced_object_read(dced_bh, &srvrconf_id, (void∗∗)&(conf), &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_iter_not_allowed

db_s_key_not_found

dced_s_not_found

sec_acl_invalid_permission

Related Information

Functions: dced_binding_create(3dce), dced_binding_from_rpc_binding(3dce), dced_inq_name(3dce). 

Books: OSF DCE Application Development Guide.