Sm_PolicyApi_AddAdmin()
Creates a new stmndr administrator object at a global scope. The administrator's attributes are contained in the pstructAdmin structure.
sm1252sp1
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 boolbUpdate);
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.