NetAddServiceAccount 함수(lmaccess.h)
NetAddServiceAccount 함수는 sMSA(독립 실행형 관리 서비스 계정)를 만들거나 gMSA(그룹 관리 서비스 계정)에 대한 자격 증명을 검색하고 로컬 컴퓨터에 계정 정보를 저장합니다.
이 함수에는 연결된 가져오기 라이브러리가 없습니다. LoadLibrary 및 GetProcAddress 함수를 사용하여 Logoncli.dll 동적으로 연결해야 합니다.
Windows Server 2008 R2: AccountName 매개 변수 값이 계정의 해당 SAM(보안 계정 관리자) 이름과 일치하지 않으면 이 함수를 호출하기 위해 PowerShell 명령줄 인터페이스 cmdlet을 사용하여 관리되는 서비스 계정을 설치하면 오류 코드 0xC0000225 실패합니다.
구문
NTSTATUS NetAddServiceAccount(
[in, optional] LPWSTR ServerName,
[in] LPWSTR AccountName,
[in] LPWSTR Password,
[in] DWORD Flags
);
매개 변수
[in, optional] ServerName
이 매개 변수의 값은 NULL이어야 합니다.
[in] AccountName
만들 계정의 이름입니다.
[in] Password
이 매개 변수는 예약되어 있습니다. 이 메서드를 사용하지 마십시오.
[in] Flags
이 매개 변수는 다음 값일 수 있습니다.
| 값 | 의미 |
|---|---|
|
독립 실행형 관리 서비스 계정이 만들어지지 않습니다. 지정된 이름의 서비스 계정이 있는 경우 로컬 컴퓨터에 연결됩니다. 계정 이름이 기존 gMSA인 경우 이 플래그는 무시됩니다. |
반환 값
함수가 성공하면 STATUS_SUCCESS 반환합니다.
함수가 실패하면 오류 코드를 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | lmaccess.h |
| DLL | Netapi32.dll |