MailFindNextHopToDomainExt

Function : Mail Gateway

MailFindNextHopToDomainExt - Find next hop to the destination domain, with additional options.

#include <mailserv.h>
STATUS LNPUBLIC MailFindNextHopToDomainExt(

    DHANDLE  hTables,
    char far *OriginatorsDomain,
    char far *DestDomain,
    DWORD  FindFlags,
    char far *NextHopServer,
    char far *NextHopMailbox,
    DWORD far *NextHopFlags,
    char far *ErrorServer);

Description :

Given a handle to a set of routing tables, the name of the originator's domain, and the name of the destination domain, obtain the server name and mailbox file name for the next step in routing a message to the destination domain.

This function differs from MailFindNextHopToDomain in that you can specify a flag that further describes the message being routed.

Note: This function assumes that the destination domain is not the domain for the local server.

Parameters : Input : hTables - Handle to routing tables to search.

OriginatorsDomain - Null-terminated string containing the name of the domain for the originator of the message.

DestDomain - Null-terminated string containing the name of the destination domain.

FindFlags - Optional. Additional flag describing the message being routed. See NEXTHOP_xxx (Input) for possible values.

Output : (routine) - Return status from this call -- indicates either sucess or what the error is. The return codes include:

NOERROR - Next hop located. ERR_ROUTER_NOROUTETODOMAIN - Cannot find route to the domain. ERR_ROUTER_NOROUTETOIDOMAIN - Cannot find a route to the internet domain in the DNS. ERR_xxx - Errors returned by lower level functions. There are so many possible causes, that it is best to use the code in a call to OSLoadString and display/log the error for the user.

NextHopServer - Null-terminated string containing the name of the next server to route the message to. The maximum length (in bytes) for this parameter is MAXUSERNAME.

NextHopMailbox - Null-terminated string containing the mailbox file name on the next hop server. The maximum length (in bytes) for this parameter is MAXPATH.

NextHopFlags - Additional flags describing the next hop server. If NEXTHOP_INTRANET bit is set, the next hop server is on the same network as the current server. If NEXTHOP_USESMTP bit is set, SMTP will be used to reach the next hop server.

ErrorServer - If no route to the specified destination domain is found, the null-terminated name of the error server is stored at this address. The maximum length (in bytes) for this parameter is MAXSPRINTF.