通过

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