NntpAuthenticate
INT NntpAuthenticate(
HCLIENT hClient,  
LPCTSTR lpszUserName,  
LPCTSTR lpszPassword  
);

The NntpAuthenticate function is used to authenticate access to the news server. Not all news servers require authentication by the client.

Parameters

hClient
Handle to the client session.
lpszUserName
Pointer to a null-terminated string which specifies the user name required for authentication on the news server.
lpszPassword
Pointer to a null-terminated string which specifies the password required for authentication on the news server.

Return Value

If the function succeeds, the return value is the server result code. If the function fails, the return value is NNTP_ERROR. To get extended error information, call NntpGetLastError.

Remarks

This function should only be called if the server requires authentication. Two authentication methods, "original" and "simple" authentication, are recognized by the library.

Requirements

Client: Requires Windows Vista, Windows XP or Windows 2000 Professional.
Server: Requires Windows Server 2008, Windows Server 2003 or Windows 2000 Server.
Header: Include cstools6.h.
Library: Use csnwsav6.lib.
Unicode: Implemented as Unicode and ANSI versions.

See Also

NntpAsyncConnect, NntpConnect, NntpListArticles, NntpListGroups


Copyright © 2008 Catalyst Development Corporation. All rights reserved.