NntpAuthenticate Function  
 
INT WINAPI 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 7, Windows Vista or Windows XP.
Server: Requires Windows Server 2008 or Windows Server 2003.
Header: Include cstools7.h.
Library: Use csnwsav7.lib.
Unicode: Implemented as Unicode and ANSI versions.

See Also

NntpAsyncConnect, NntpConnect, NntpListArticles, NntpListGroups