Sm_PolicyApi_AddAdmin()

Creates a new stmndr administrator object at a global scope. The administrator's attributes are contained in the pstructAdmin structure.
casso10
Creates a new
CA Single Sign-On
administrator object at a global scope. The administrator's attributes are contained in the
pstructAdmin
structure.
If the administrator object exists and
bUpdate
is true, the item is updated.
Type
Administrator function, global scope.
Syntax
int SM_EXTERN Sm_PolicyApi_AddAdmin (
void*
pSessionHandle
,
Sm_PolicyApi_Admin_t*
pstructAdmin
,
const bool
bUpdate
);
Parameter
I/O
Description
pSessionHandle
I
A pointer to an internal Policy Management API data structure. The structure holds information about the administrator session and the client session.
pstructAdmin
I
A pointer to a completely filled-in administrator structure.
bUpdate
I
A flag to indicate that if an existing object is found, it should be updated.
 
Returns
  • Sm_PolicyApi_Success. The administrator object was created successfully.
  • Sm_PolicyApi_Failure. The administrator object was not created successfully.
  • Sm_PolicyApi_InvalidHandle. There was no valid initialization prior to this call.
  • Sm_PolicyApi_NoSession. There is no valid administrator session.
  • Sm_PolicyApi_NoPrivilege. The administrator does not have the privilege to create an administrator object.
  • Sm_PolicyApi_InvalidOid:
    • The administrator object identifier was not found during an update.
    • The user directory object identifier was not found.
    • The scheme object identifier was not found.