pam_end 子例程

在线编辑

用途

结束现有 PAM 认证会话。

库

PAM 库 (libpam.a)

语法

#include <security/pam_appl.h>

int pam_end (PAMHandle, Status)
pam_handle_t *PAMHandle;
int Status;

描述

pam_end 子例程完成并清除由 PAM 句柄 PAMHandle表示的认证会话。 Status 表示 PAMHandle 的当前状态，并传递到 cleanup () 函数，以便可以正确取消分配该会话期间使用的内存。 cleanup () 函数可以由 PAM 模块通过 pam_set_data () 例程在 PAMHandle 中设置。 当子例程完成时， PAM 句柄和关联的内存不再有效。

参数

项 描述
PAMhandle 表示当前用户认证会话的 PAM 句柄。 此句柄通过调用 pam_start ()获取。
状态 上次 PAM 调用的状态。 某些模块需要根据错误代码进行清理。

返回值

成功完成后， pam_end 将返回 PAM_SUCCESS。 如果例程失败，那么将根据实际错误返回其他错误。

错误代码

项 描述
PAM_SYSTEM_ERR 发生系统错误。
PAM_BUF_ERR 发生内存错误。