SetComputerNameA 함수(sysinfoapi.h)
로컬 컴퓨터의 새 NetBIOS 이름을 설정합니다. 이름은 레지스트리에 저장되며 다음번에 사용자가 컴퓨터를 다시 시작할 때 이름 변경이 적용됩니다.
로컬 컴퓨터가 클러스터의 노드인 경우 SetComputerName 클러스터 가상 서버가 아닌 로컬 컴퓨터의 NetBIOS 이름을 설정합니다.
DNS 호스트 이름 또는 DNS 도메인 이름을 설정하려면 SetComputerNameEx 함수를 호출합니다.
통사론
BOOL SetComputerNameA(
[in] LPCSTR lpComputerName
);
매개 변수
[in] lpComputerName
다음에 컴퓨터를 시작할 때 적용되는 컴퓨터 이름입니다. 이름은 MAX_COMPUTERNAME_LENGTH 문자보다 길면 안 됩니다.
표준 문자 집합에는 문자, 숫자 및 다음 기호가 포함됩니다. ! @ # $ % ^ & ' ) ( . - _ { } ~ . 이 매개 변수에 표준 문자 집합 외부에 있는 문자가 하나 이상 포함된 경우 SetComputerName ERROR_INVALID_PARAMETER 반환합니다.
반환 값
함수가 성공하면 반환 값은 0이 아닌 값입니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError호출합니다.
발언
이 함수를 사용하는 애플리케이션에는 관리자 권한이 있어야 합니다.
메모
sysinfoapi.h 헤더는 SETComputerName을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | sysinfoapi.h(Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |
참고 항목
컴퓨터 이름
GetComputerName
GetComputerNameEx
SetComputerNameEx