This method attempts to bind a TCP/IP socket to the POP3 server port 110 on the machine specified. If successful, it attempts to properly authenticate using the username and password specified. It then closes the socket. Use this method to check the connectivity to the POP3 server before starting a mailing package.
IDL Definition
HRESULT CheckPOP3Password(
[in] BSTR bstrPOP3,
[in] BSTR bstrAcct,
[in] BSTR bstrPwd
);
Parameters
bstrPOP3
the name of the machine hosting the POP3 server. This name must be a valid DNS name for a machine on the network. The name is resolved to an IP address which is used to bind a TCP/IP socket to that machine using the default POP3 port 110.
bstrAcct
the USER value to present when authenticating.
bstrPwd
the PASS value to present when authenticating.
Return Values
the HRESULT can have one of the following values:
#define Name | Description |
S_OK | success. |
TMAIL_E_CONNECT_FAILED | a TCP/IP connection could not be established with the target machine. |