EM_ADD_AUTH_DETAILS Function

Purpose

Adds authentication details to an existing connection.

Syntax

EM_ADD_AUTH_DETAILS(auth-details)

Syntax elements

auth-detailsThe user and password details required for authentication with the mail server.

Attribute

Name

Description

1

USER

The name of the user account with which to login to the mail server. If this is not set (null), no authentication is used.

2

PASSWORD

The password of the user account. If no user account is defined, the password is ignored.

Returns

None

Comments

This function is intended to be used after EM_START_EMAIL to override any authentication details in the existing configuration if necessary.

You must include the item #EM_INCLUDES in all programs that use the Email API functions; for example, you could add the line

INCLUDE #EM_INCLUDES FROM /SYSFILES/SYS.BASLIB

at the start of the program, or create an item to be automatically included that contains this line.