authxapi_GetUserInfo 函数

SDK 指南 › 退出 API › authxapi_GetUserInfo 函数

authxapi_GetUserInfo 函数

在 UNIX 上有效

在提供 CA ControlMinder 用户的 ACEE 句柄时，authxapi_GetUserInfo 函数将检索用户名。

如果函数成功，则返回 0。如果失败，则设置全局变量 errno，并返回以下错误代码之一：

返回值	ERRNO	含义
AUTHXAPI_E_EINVAL	EINVAL	指针无效 (NULL)
AUTHXAPI_E_INVOBJ	EINVAL	对象描述符无效
AUTHXAPI_E_INVPROP	EINVAL	属性描述符无效
AUTHXAPI_E_NOCLASS	ENOENT	未找到所需的类
AUTHXAPI_E_NOOBJ	ENOENT	未找到所需的对象
AUTHXAPI_E_NOPROP	ENOENT	未找到所需的属性
AUTHXAPI_E_PTYPE	EINVAL	属性类型为列表
AUTHXAPI_E_DBERROR	EIO	怀疑数据库损坏
AUTHXAPI_E_NOVAL	ENOENT	没有与该对象关联的属性的值

int authxapi_GetUserInfo (int  seos_handle,
                          char *uname,
                          int  *size);

seos_handle: 请求其用户名的用户的句柄。
uname: 缓冲区足够大，以包含返回的用户名。一些 UNIX 系统不允许每个名称超过 8 个字符，而其他一些系统允许。 CA ControlMinder 将用户视为任何其他对象，并允许每个名称可长达 255 字节。
size: 进入时，指的是 uname 指向的内存区域的大小（以字节为单位）。返回时，指的是用户名字符串的长度。

示例：获取用户名字符串

此示例说明如何获取用户名字符串。

{
    int rc;
    char name[256];
    int size;
    ...
    size = sizeof (name)
    rc = authxapi_GetUserInfo(seos_handle, name, &size);
        ...
}

适用于 Windows 的函数

由 CA ControlMinder 提供的 API exit 函数实际上分类为回调。它们又分为以下两个类别：

用户定义的函数－在 CA ControlMinder 执行期间调用用户定义的函数，并根据函数注册类型调用每个函数。
注册和初始化函数－在 seosd 服务和 wdchange.dll 启动期间，调用一次此函数。其目的是初始化任何内部数据并注册用户定义的函数。