subrotina pam_getenvlist

Editar online

Propósito

Retorna uma lista de todas as variáveis de ambiente PAM definidas e seus valores.

Biblioteca

Biblioteca PAM (libpam.a)

Sintaxe

#include <security/pam_appl.h>

char **pam_getenvlist (PAMHandle)
pam_handle_t *PAMHandle;

Descrição

O subroutine pam_getenvlist retorna um ponteiro para uma lista das variáveis de ambiente atualmente definidas na alça PAM, PAMHandle. As variáveis de ambiente podem ser definidas através de chamadas para a subroutine pam_putenv () . A biblioteca retorna o ambiente em uma matriz alocada na qual a última entrada da matriz é NULL. O responsável pela chamada é responsável por libertar a memória da lista devolvida.

Parâmetros

Item Descrição
PAMHandle A alça PAM representando a sessão de autenticação do usuário atual. Essa alça é obtida por uma chamada para pam_start ().

Valores De Retorno

Após a conclusão bem-sucedida, pam_getenvlist retorna um ponteiro para uma lista de strings, uma para cada variável de ambiente PAM atualmente definida. Cada string é do formulário VARIÁVEL=VALOR, onde VARIABLE é o nome da variável e VALOR é o seu valor. Esta lista é finalizada com uma entrada NULL. Se a rotina falhar ou não houver variáveis de ambiente PAM definidas, uma referência NULL será devolvida. O ouvinte é responsável por libertar a memória do valor retornado.