FingerUser Function  
 
INT WINAPI FingerUser(
  HCLIENT hClient,  
  LPCTSTR lpszUserName  
);

The FingerUser function sends the specified username to the server, which then returns information about the given user. To read the information returned by the server, the FingerRead function should be used.

Parameters

hClient
Handle to the client session.
lpszUserName
The pointer to the string that contains the username to return information about.

Return Value

If the function succeeds, the return value is zero. If the function fails, the return value is FINGER_ERROR. To get extended error information, call FingerGetLastError.

Remarks

The type and format of the information returned about a user is determined by the server. Most servers return information such as the date and time the user was last logged in and if the user has any new mail waiting. They may also return the contents of one or more files created by the user which they feel might be of interest to others.

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 csfgrav7.lib.
Unicode: Implemented as Unicode and ANSI versions.

See Also

FingerIsConnected, FingerIsReadable, FingerRead