SetComputerName
The SetComputerName
function sets the computer name to be used the next time the system is
restarted.
BOOL SetComputerName(
|
LPCTSTR lpComputerName |
// address of new
computer name |
|
); |
|
Parameters
lpComputerName
Points to a
null-terminated character string that specifies the name that will be the
computer name the next time the computer is started. The name must not be
longer than MAX_COMPUTERNAME_LENGTH characters.
Windows
95: If this string contains one or
more characters that are outside the standard character set, those characters
are coerced into standard characters.
Windows
NT: If this string contains one or
more characters that are outside the standard character set, SetComputerName
returns ERROR_INVALID_PARAMETER. It does not coerce the characters outside the
standard set.
The standard
character set includes letters, numbers, and the following symbols: ! @ # $ % ^
& ) ( . - _ { } ~ .
Return Values
If the function
succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
Applications
using this function must have administrator rights.
See Also