dpm_getspacetoken - get space token
#include <sys/types.h>
#include "dpm_api.h"
int dpm_getspacetoken (const char *u_token,
int *nbreplies, char
***s_tokens)
dpm_getspacetoken gets the list of space tokens associated
with this user description.
The input argument is:
- u_token
- specifies the user provided description associated with a previous
reservespace request. If the argument is NULL, all the space tokens
accessible by the user will be listed.
The output arguments are:
- nbreplies
- will be set to the number of replies in the array of space tokens.
- s_tokens
- will be set to the address of an array of space tokens allocated by the
API. The client application is responsible for freeing the array when not
needed anymore.
This routine returns 0 if the operation was successful or -1 if
the operation failed. In the latter case, serrno is set
appropriately.
- EFAULT
- nbreplies or s_tokens is a NULL pointer.
- ENOMEM
- Memory could not be allocated for storing the reply.
- EINVAL
- The length of the user space token description is greater than 255 or the
user space token description is unknown.
- SENOSHOST
- Host unknown.
- SEINTERNAL
- Database error.
- SECOMERR
- Communication error.