Share via

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

此參數可以是下列值。

值 意義
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