Reads the current process credentials.
Security Library (libc.a)
char **getpcred (Which) int Which;
The getpcred subroutine reads the specified process security credentials and returns them in a character buffer.
|Which|| Specifies which credentials are read. This parameter is a bit mask and can contain one or more of the following values, as defined in the usersec.h file:
When successful, the getpcred subroutine returns a pointer to a string containing the requested values. If the getpcred subroutine is unsuccessful, a null pointer is returned and the errno global variable is set to indicate the error.
The getpcred subroutine fails if either of the following are true:
|EINVAL||The Which parameter contains invalid credentials requests.|
|EPERM||The process does not have the proper authority to retrieve the requested credentials.|
Other errors can also be set by any subroutines invoked by the getpcred subroutine.
This subroutine is part of Base Operating System (BOS) Runtime.
The ckuseracct subroutine, ckuserID subroutine, getpenv subroutine, setpenv subroutine, setpcred subroutine.
List of Security and Auditing Subroutines, Subroutines Overview in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.