NetAddServiceAccount 函式 (lmaccess.h)
NetAddServiceAccount 函式會建立獨立受控服務帳戶 (sMSA) 或擷取群組受控服務帳戶的認證, (gMSA) ,並將帳戶資訊儲存在本機計算機上。
此函式沒有相關聯的匯入連結庫。 您必須使用 LoadLibrary 和 GetProcAddress 函式,以動態方式連結至 Logoncli.dll。
Windows Server 2008 R2: 使用 PowerShell 命令行介面 Cmdlet 來安裝受控服務帳戶時,當 AccountName 參數的值與帳戶的對應 安全性帳戶 管理員 (SAM) 名稱不符時,錯誤碼會失敗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 |