Send Operations

This topic discusses the send operation.

Syntax

int FAR PASCAL PsfSendForm(HSESSIONhSession, LPPSFFORMDEFNlpFormData);

Description

Sends a form through the mail system with the specified field values.

PsfSendForm sends a form using the specified open session. The lpFormData structure has values in all fields, including the data values in the field array that it points to.

Parameters

Parameter	Description
hSession	The session handle assigned by PsfOpenSession when PeopleSoft connected to PSFORMS.DLL.
lpFormData	A pointer to a structure that contains form information. The form of the structure is: `typedef struct { PSFDEFNKEYformName; // Name of the form WORD wNumFields; // Number of fields charcSep; // Separator character LPPSFFIELDVAL lpFields; // Pointer to array } PSFFORMDEFN;`
	Each item in the field array has this structure: `typedef struct { char szFldName[PSF_FORMNAMELEN + 1]; // Field name WORD wFldSize; // Field size LPSTR lpszStrVal; // Value } PSFFIELDVAL;`

Parameter

Description

hSession

The session handle assigned by PsfOpenSession when PeopleSoft connected to PSFORMS.DLL.

lpFormData

A pointer to a structure that contains form information. The form of the structure is:

typedef struct
{
   PSFDEFNKEYformName;   // Name of the form
   WORD wNumFields; // Number of fields
   charcSep;    // Separator character
   LPPSFFIELDVAL lpFields;   // Pointer to array
} PSFFORMDEFN;

Each item in the field array has this structure:

typedef struct
{
   char szFldName[PSF_FORMNAMELEN + 1]; // Field name
   WORD wFldSize;    // Field size
   LPSTR lpszStrVal;    // Value
} PSFFIELDVAL;

Returns

This operation returns the following values:

Value	Code	Meaning
PSF_OK	0	The function ran successfully.
PSF_NOFIELD	1	A field is missing or is the wrong size.
PSF_NOMAIL	2	Mail system failed.
PSF_NOFORM	3	The form is not accessible.
PSF_NODB	5	The forms database is not accessible.