rd_createticket — Rivendell Create Ticket C Library Function
#include <rivwebcapi/rd_createticket.h>
int RD_CreateTicket( | ticketinfo[], | |
| hostname[], | ||
| username[], | ||
| passwd[], | ||
| user_agent[], | ||
numrecs); |
struct rd_ticketinfo * ticketinfo[];const char hostname[];const char username[];const char passwd[];const char user_agent[];unsigned * numrecs;RD_CreateTicket is the function to use to create a Authentification Ticket within the Rivendell Database.
Table 1. RD_CreateTicket function call fields
| FIELD NAME | FIELD TYPE | MEANING | REMARKS |
|---|---|---|---|
| *rd_audioinfo | Pointer to rd_ticketinfo structure | Memory location to store specific ticketinfo data | Mandatory |
| hostname | Character Array | Name Of Rivendell DB Host | Mandatory |
| username | Character Array | Rivendell User Name | Mandatory |
| passwd | Character Array | Rivendell User Password | Mandatory |
| user_agent | Character Array | User Agent Value put into HTTP request | Optional (default is Rivendell-C-API/x.x.x) |
| *numrecs | pointer to integer | memory location for number of records returned | Mandatory |
When successful function will return the number of records sent (numrecs) and a rd_ticketinfo structure which is stored in the provided memory locations. The rd_ticketinfo structure has the following fields:
struct rd_ticketinfo {
char ticket[40];
struct tm tkt_expiration_datetime;
}