Функция NetAddServiceAccount (lmaccess.h)

Статья
08/24/2023

Функция NetAddServiceAccount создает автономную управляемую учетную запись службы (sMSA) или извлекает учетные данные для групповой управляемой учетной записи службы (gMSA) и сохраняет сведения об учетной записи на локальном компьютере.

У этой функции нет связанной библиотеки импорта. Для динамической связи с Logoncli.dll необходимо использовать функции LoadLibrary и GetProcAddress .

Windows Server 2008 R2: Установка управляемой учетной записи службы с помощью командлета интерфейса командной строки PowerShell для вызова этой функции завершается сбоем с кодом ошибки 0xC0000225, если значение параметра AccountName не соответствует соответствующему имени диспетчера учетных записей безопасности (SAM) учетной записи.

Синтаксис

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.

Значение

SERVICE_ACCOUNT_FLAG_LINK_TO_HOST_ONLY
0x00000001

Автономная управляемая учетная запись службы не создается. Если учетная запись службы с указанным именем существует, она связана с локальным компьютером. Этот флаг игнорируется, если имя учетной записи является существующим gMSA.

Возвращаемое значение

Если функция выполняется успешно, она возвращает STATUS_SUCCESS.

Если функция завершается сбоем, она возвращает код ошибки.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	lmaccess.h
DLL	Netapi32.dll

См. также раздел

NetEnumerateServiceAccounts

NetIsServiceAccount

NetRemoveServiceAccount

Поделиться через