|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| No
| Import Library
| advapi32.lib
| Header File
| winbase.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
GetUserName
The GetUserName function retrieves the user name of the current thread. This is the name of
the user currently logged onto the system.
BOOL GetUserName(
LPTSTR lpBuffer,
| // address of name buffer
| LPDWORD nSize
| // address of size of name buffer
| );
|
|
Parameters
lpBuffer
Points to the buffer to receive the null-terminated string containing the
user's logon name. If this buffer is not large enough to contain the entire user
name, the function fails.
nSize
Pointer to a DWORD that, on input, specifies the maximum size, in characters, of the buffer
specified by the lpBuffer parameter. If this buffer is not large enough to contain the entire user
name, the function fails. If the function succeeds, it will place the number of
characters copied to the buffer into the DWORD that nSize points to.
Return Values
If the function succeeds, the return value is nonzero, and the variable
pointed to by nSize contains the number of characters copied to the buffer specified by lpBuffer, including the terminating null character.
If the function fails, the return value is zero. To get extended error
information, call GetLastError.
Remarks
If the current thread is impersonating another client, the GetUserName function returns the user name of the client that the thread is
impersonating.
See Also
LookupAccountName
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
