NAME

sec_rgy_attr_cursor_alloc-Allocates resources to a cursor used by the sec_rgy_attr_lookup_by_id() call

SYNOPSIS

#include <dce/sec_rgy_attr.h>

void sec_rgy_attr_cursor_alloc(
    sec_attr_cursor_t *cursor,
    error_status_t *status);

PARAMETERS

Output

cursor

A pointer to a sec_attr_cursor_t.

status

A pointer to the completion status. On successful completion, the call returns error_status_ok. Otherwise, it returns an error.

DESCRIPTION

The sec_rgy_attr_cursor_alloc() call allocates resources to a cursor used with the sec_rgy_attr_lookup_by_id() call. This routine, which is a local operation, does not initialize cursor.

The sec_rgy_attr_cursor_init() routine, which makes a remote call, allocates and initializes the cursor. In addition, sec_rgy_attr_cursor_init() returns the total number of attributes attached to the object as an output parameter; sec_rgy_attr_cursor_alloc() does not.

Permissions Required

None

FILES

/usr/include/dce/sec_rgy_attr.idl

The idl file from which dce/sec_rgy_attr.h was derived.

ERRORS

error_status_ok

The call was successful.

sec_rgy_object_not_found

Registry object not found.

SEE ALSO

Functions: sec_rgy_attr_cursor_init(), sec_rgy_attr_cursor_release(), sec_rgy_attr_cursor_reset(), sec_rgy_attr_lookup_by_id().