NAME
dpm_getreqid - get request id for a set of requests
SYNOPSIS
#include <sys/types.h>
#include "dpm_api.h"
int dpm_getreqid (char *u_token, int *nbreplies, struct dpm_tokeninfo
**tokeninfos)
DESCRIPTION
dpm_getreqid gets request id for a set of requests.
The input argument is:
u_token
specifies the user provided description associated with a
previous get/put/copy request.
The output arguments are:
nbreplies
will be set to the number of replies in the array of token
infos.
tokeninfos
will be set to the address of an array of dpm_tokeninfo
structures allocated by the API. The client application is
responsible for freeing the array when not needed anymore.
struct dpm_tokeninfo {
char r_token[CA_MAXDPMTOKENLEN+1];
time_t c_time;
};
RETURN VALUE
This routine returns 0 if the operation was successful or -1 if the
operation failed. In the latter case, serrno is set appropriately.
ERRORS
EFAULT nbreplies or tokeninfos is a NULL pointer.
ENOMEM Memory could not be allocated for storing the reply.
EINVAL The length of the user request description is greater than
255 or the user request description is unknown.
SENOSHOST Host unknown.
SEINTERNAL Database error.
SECOMERR Communication error.