Obtains a user's fully distinguished object name from the Census and copies it into the buffer supplied by the caller.
#include <ascauth.h>
int ASC_GETCONTEXT(ASCENV *asce, char *user, char *buffer, u_int size);
|
asce |
The environment item returned from the call to ASC_INIT() or ASC_INIT_EXT(). |
|
user |
The Enterprise User ID. |
|
buffer |
The buffer that is to receive the context. The result is truncated and the call returns AS_TOOSMALL if the buffer size cannot hold the entire result. |
|
size |
The length in bytes of the buffer. |
Returns one of the following integer values defined in ascauth.h:
|
AS_OK |
Context was found |
|
AS_NOUSER |
User inactive or not found in the Census |
|
AS_BADCLIENT |
Local host not authorized to query the Core Driver |
|
AS_NOAGENT |
No Core Driver could be contacted |
|
AS_NOAUTHENV |
No environment has been established |
|
AS_INVALIDREQ |
Call rejected by the Core Driver as not valid or not supported |
|
AS_INVALIDARGS |
Invalid arguments supplied to the function |
|
AS_TOOSMALL |
Size of the pre-allocated buffer is too small-result truncated |
|
AS_KEYEXPIRED |
Old key rejected by the Core Driver because the expiration date has passed |
The buffer is padded with nulls if needed.
The format of the returned login context is the simple dot form. For example: .jondoe.j.myorg
#include <stdio.h>
#include <stdlib.h>
#include <ascauth.h>
#define MAX_CONTEXT 512
main(int argc, char *argv[])
{
ASCENV *asce;
char *user, *context;
int rc;
if (argc != 2) {
fprintf(stderr, "usage: %s <user>\n", argv[0]);
exit(EXIT_FAILURE);
}
user = argv[1];
/* allocate buffer */
context = (char *) malloc(MAX_CONTEXT);
/* initialize the authentication environment */
asce = ASC_INIT(NULL);
if (asce == NULL) {
fprintf(stderr, "Error: cannot initialize authentication environment\n");
exit(EXIT_FAILURE);
}
/* get the user's context */
rc = ASC_GETCONTEXT(asce, user, context, MAX_CONTEXT);
if (rc == AS_OK)
printf("context is %s\n", context);
else
printf("RC=%d, %s", rc, ASC_STRERROR(rc));
free(context);
/* now terminate the authentication environment */
ASC_TERM(asce);
return 0;
}