PreviousNext

rpc_ns_group_delete(3rpc)

Deletes a group attribute

Used by client, server, or management applications.

Synopsis

#include <dce/rpc.h>

void rpc_ns_group_delete(

unsigned32 group_name_syntax,

unsigned_char_t *group_name,

unsigned32 *status);

Parameters

Input

group_name_syntax
An integer value that specifies the syntax of the group_name parameter.

To use the syntax specified in the RPC_DEFAULT_ENTRY_SYNTAX environment variable, provide the integer value rpc_c_ns_syntax_default.

group_name
Specifies the RPC group to delete. This can be either the global or cell-relative name.

Output

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

Description
The rpc_ns_group_delete( ) routine deletes the group attribute from the specified entry in the name service database.

Neither the specified entry nor the entries represented by the group members are deleted.

Permissions Required
You need write permission to the CDS object entry (the target group entry).

Return Values
No value is returned.

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
Success.

rpc_s_entry_not_found
Name service entry not found.

rpc_s_incomplete_name
Incomplete name.

rpc_s_invalid_name_syntax
Invalid name syntax.

rpc_s_name_service_unavailable
Name service unavailable.

rpc_s_no_ns_permission
No permission for name service operation.

rpc_s_unsupported_name_syntax
Unsupported name syntax.

Related Information
Functions: rpc_ns_group_mbr_add(3rpc)

rpc_ns_group_mbr_remove(3rpc)