smfi_delrcpt.3n (2010 09)

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.

PAGE 1
smfi_delrcpt(3N) smfi_delrcpt(3N) NAME smfi_delrcpt() - removes a recipient from envelope of current sendmail message SYNOPSIS #include int smfi_delrcpt( SMFICTX *ctx ; char *rcpt ; ); PARAMETERS ctx Specifies the opaque context structure. rcpt Specifies 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.
PAGE 2
(Notes) A (Notes) sA 2 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010