NetAddServiceAccount-Funktion (lmaccess.h)

  • Artikel

Die NetAddServiceAccount-Funktion erstellt ein eigenständiges verwaltetes Dienstkonto (sMSA) oder ruft die Anmeldeinformationen für ein gruppenverwaltetes Dienstkonto (gMSA) ab und speichert die Kontoinformationen auf dem lokalen Computer.

Diese Funktion verfügt über keine zugeordnete Importbibliothek. Sie müssen die Funktionen LoadLibrary und GetProcAddress verwenden, um eine dynamische Verknüpfung mit Logoncli.dll.

Windows Server 2008 R2: Beim Installieren eines verwalteten Dienstkontos mithilfe des PowerShell-Befehlszeilenschnittstellen-Cmdlets zum Aufrufen dieser Funktion schlägt ein Fehlercode 0xC0000225 fehl, wenn der Wert des Kontoname-Parameters nicht mit dem entsprechenden Sam-Namen (Security Accounts Manager ) des Kontos übereinstimmt.

Syntax

NTSTATUS NetAddServiceAccount(
  [in, optional] LPWSTR ServerName,
  [in]           LPWSTR AccountName,
  [in]           LPWSTR Password,
  [in]           DWORD  Flags
);

Parameter

[in, optional] ServerName

Der Wert dieses Parameters muss NULL sein.

[in] AccountName

Der Name des zu erstellenden Kontos.

[in] Password

Dieser Parameter ist reserviert. Verwenden Sie sie nicht.

[in] Flags

Dieser Parameter kann der folgende Wert sein.

Wert Bedeutung
SERVICE_ACCOUNT_FLAG_LINK_TO_HOST_ONLY
0x00000001
 Es wird kein eigenständiges verwaltetes Dienstkonto erstellt. Wenn bereits ein Dienstkonto mit dem angegebenen Namen vorhanden ist, wird es mit dem lokalen Computer verknüpft. Dieses Flag wird ignoriert, wenn es sich bei dem Kontonamen um einen vorhandenen gMSA handelt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie STATUS_SUCCESS zurück.

Wenn die Ausführung der Funktion fehlschlägt, wird ein Fehlercode zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile lmaccess.h
DLL Netapi32.dll

Weitere Informationen

NetEnumerateServiceAccounts

NetIsServiceAccount

NetRemoveServiceAccount