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

이 매개 변수는 다음 값일 수 있습니다.

값	의미
SERVICE_ACCOUNT_FLAG_LINK_TO_HOST_ONLY 0x00000001	독립 실행형 관리 서비스 계정이 만들어지지 않습니다. 지정된 이름의 서비스 계정이 있는 경우 로컬 컴퓨터에 연결됩니다. 계정 이름이 기존 gMSA인 경우 이 플래그는 무시됩니다.

반환 값

함수가 성공하면 STATUS_SUCCESS 반환합니다.

함수가 실패하면 오류 코드를 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	lmaccess.h
DLL	Netapi32.dll

추가 정보

NetEnumerateServiceAccounts

NetIsServiceAccount

NetRemoveServiceAccount