Previous section.

DCE 1.1: Authentication and Security Services
Copyright © 1997 The Open Group

NAME

sec_login_get_groups-Retrieve (read) local host group membership information from a login context

SYNOPSIS

#include <dce/sec_login.h>

void sec_login_get_groups (
    sec_login_handle_t login_context,
    unsigned32 *count,
    signed32 **groups,
    error_status_t *status );

PARAMETERS

Input

login_context

Login context from which group membership information is to be retrieved.

Output

count

Number of local groups in the array groups.

groups

The list of local groups indicated in the login context. (The datatype of groups, unsigned32, is intended to be converted to a host-specific datatype. For example, on POSIX-compliant operating systems, it is intended to be converted to the gid_t datatype.)

status

The completion status.

DESCRIPTION

The sec_login_get_groups() routine returns the local group information from a login context.

The routine works only on previously validated contexts.

ERRORS

error_status_ok

sec_login_s_context_invalid

sec_login_s_default_use

sec_login_s_info_not_avail

sec_login_s_not_certified

sec_rgy_object_not_found

sec_rgy_server_unavailable

SEE ALSO

Functions: sec_rgy_acct_get_projlist(), sec_login_get_pwent().
Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.

Contents Next section Index