pam_getenv 子例程

用途

返回已定义的 PAM 环境变量的值。

PAM 库 (libpam.a)

语法

#include <security/pam_appl.h>

char *pam_getenv (PAMHandle, VarName)
pam_handle_t *PAMHandle;
char *VarName;

描述

pam_getenv 子例程检索 PAM 句柄 PAMHandle中存储的 PAM 环境变量 VarName 的值。 可以通过 pam_putenv () 调用来定义环境变量。 如果定义了 VarName ,那么将在库分配的内存中返回其值; 调用者负责释放此内存。 否则,将返回 NULL 指针。

参数

描述
PAMHandle 表示当前用户认证会话的 PAM 句柄。 此句柄通过调用 pam_start ()获取。
VarName 要获取其值的 PAM 环境变量的名称。

返回值

成功完成后, pam_getenv 将返回 VarName PAM 环境变量的值。 如果例程失败或未定义 VarName ,那么将返回 NULL。