HP-UX Reference (11i v3 07/02) - 3 Library Functions N-Z (vol 7)

smﬁ_delrcpt(3N) smﬁ_delrcpt(3N)

NAME

smﬁ_delrcpt() - removes a recipient from envelope of current sendmail message

SYNOPSIS

#include <libmilter/mfapi.h>

int smfi_delrcpt(

SMFICTX *

ctx;

char *

rcpt;

);

PARAMETERS

ctx Speciﬁes the opaque context structure.

rcpt Speciﬁes the recipient address to be removed, which is a non-NULL, null-terminated string.

DESCRIPTION

smfi_delrcpt()

removes the named recipient from the envelope of the current message.

smfi_delrcpt() can be called only from the

xxfi_eom() routine.

Notes

The addresses to be removed must match exactly. For example, if an address and its expanded form do not

match, the address is not removed.

RETURN VALUE

smfi_delrcpt() fails and returns

MI_FAILURE due to the following reasons:

• The rcpt variable is NULL.

• Deleting recipients in the current connection state is invalid.

• Network error occurs.

• The

SMFIF_DELRCPT is not set when the

smfi_register() routine is called.

smfi_delrcpt returns MI_SUCCESS on success.

AUTHOR

smfi_dlercpt() was developed by the Sendmail Inc.