SendAppointment()

Schedules an appointment.

Token ID

AFTKN_SEND_APPT or 581

Syntax

DWORD SendAppointment( ANSISTRING To; 
                       [ANSISTRING Subject]; 
                       [WORD StartDay]; 
                       [WORD StartMonth]; 
                       [WORD StartYear]; 
                       [WORD StartMinute]; 
                       [WORD StartHour]; 
                       [WORD EndDay]; 
                       [WORD EndMonth]; 
                       [WORD EndYear]; 
                       [WORD EndMinute]; 
                       [WORD EndHour]; 
                       [ANSISTRING Message]; 
                       [ANSISTRING Attach]; 
                       [ANSISTRING Place]; 
                       [ANSISTRING CC]; 
                       [ANSISTRING BC]; 
                       [ANSISTRING From]; 
                       [ANSISTRING ViewName]; 
                       [ENUM AttachListHasDisplayNames]; 
                       [ANSISTRING UserID]; 
                       [ANSISTRING MessageIDs]; 
                       [ENUM MessageIsFile]; 
                       [ENUM SubjectIsFile]; 
                       [ENUM ViewNameIsFile]; 
                       [ANSISTRING OleAttach]; 
                       [ANSISTRING SenderID])

Parameters

To As ANSISTRING

User ID of one or more appointment recipients. Separate multiple recipients with commas.

Subject As ANSISTRING

Parameter also accepts a file name. (Optional)

StartDay As WORD

(Optional)

StartMonth As WORD

(Optional)

StartYear As WORD

(Optional)

StartMinute As WORD

(Optional)

StartHour As WORD

(Optional)

EndDay As WORD

(Optional)

EndMonth As WORD

(Optional)

EndYear As WORD

(Optional)

EndMinute As WORD

(Optional)

EndHour As WORD

(Optional)

Message As ANSISTRING

Parameter also accepts a file name. (Optional)

Attach As ANSISTRING

Separate multiple attachments with commas. (Optional)

Place As ANSISTRING

(Optional)

CC As ANSISTRING

User ID of one or more carbon copy recipients. Separate multiple recipients with commas. (Optional)

BC As ANSISTRING

User ID of one or more blind copy recipients. Separate multiple recipients with commas. (Optional)

From As ANSISTRING

Name of person scheduling the appointment. (Optional)

ViewName As ANSISTRING

Name of an Appointment view, such as "Meeting w/attach", or the name of a custom Appointment view. Parameter also accepts a file name. (Optional)

AttachListHasDisplayNames As ENUM

(Optional)

  • 0 No
  • 1 Yes and the Attach parameters must include the file name and display name for each attachment, respectively.
UserID As ANSISTRING

Use this parameter to schedule an appointment from a proxy mailbox. (Optional)

MessageIDs As ANSISTRING

Attach encapsulated items. Separate multiple message IDs with a comma. (Optional)

MessageIsFile As ENUM

Message parameter contains a file name. (Optional)

  • 0 No
  • 1 Yes
SubjectIsFile As ENUM

Subject parameter contains a file name. (Optional)

  • 0 No
  • 1 Yes
ViewNameIsFile As ENUM

ViewName parameter contains a file name. (Optional)

  • 0 No
  • 1 Yes
OleAttach As ANSISTRING

(Optional)

SenderID As ANSISTRING

(Optional)

Return Values

  • IDforEnvSentMessageID DWORD. Staged message ID for tracking an appointment item. Use EnvSentMessageID() token to get actual message ID of the appointment.

Remarks

The message body field (in the Message View and the Object API) has a limit of 32,000 characters. The Message View will stop accepting data after 32,000 characters.