smtp_next_state

March 26, 2020 Contributors

Name

smtp_next_state — Change the SMTP state for the current connection to another state

Synopsis

#include "smtp.h"

| void **smtp_next_state** ( | dc, |   |
|   | connh, |   |
|   | state, |   |
|   | now); |   |

delivery_construct * <var class="pdparam">dc</var>;
connection_handle * <var class="pdparam">connh</var>;
smtp_state * <var class="pdparam">state</var>;
struct timeval * <var class="pdparam">now</var>;

Description

Change the SMTP state for the current connection to another state.

Parameters

dc

The address of a delivery_construct for the connection. For more information on this data structure see “delivery_construct”.

connh

The address of a connection_handle. For more information on this data structure see “connection_handle”.

state

Move the connection state to this SMTP state. One typical usage is to use smtp_get_state as an argument. Another typical usage is to pass the NULL pointer. In this case, then move the connection state to the next (default) state. For more information on this data structure see “smtp_state”.

now

A pointer to a timeval struct, which may be NULL.

**Configuration Change. ** Prior to version 3.0, NULL was not an allowed value.

Return Values

This function returns void.

Threading

It is only legal to call this function in the Scheduler thread.

See Also

ec_smtp_closeconn and register_smtp_client_state