NetAddServiceAccount, fonction (lmaccess.h)

Article
02/28/2024

La fonction NetAddServiceAccount crée un compte de service managé autonome (sMSA) ou récupère les informations d’identification d’un compte de service géré de groupe (gMSA) et stocke les informations de compte sur l’ordinateur local.

Cette fonction n’a pas de bibliothèque d’importation associée. Vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour établir une liaison dynamique vers Logoncli.dll.

Windows Server 2008 R2 : L’installation d’un compte de service géré à l’aide de l’applet de commande de l’interface de ligne de commande PowerShell pour appeler cette fonction échoue avec le code d’erreur 0xC0000225 lorsque la valeur du paramètre AccountName ne correspond pas au nom sam (Security Accounts Manager ) correspondant du compte.

Syntaxe

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

Paramètres

[in, optional] ServerName

La valeur de ce paramètre doit être NULL.

[in] AccountName

Le nom du compte qui doit être créé.

[in] Password

Ce paramètre est réservé. Ne pas l'utiliser.

[in] Flags

Ce paramètre peut être la valeur suivante.

Valeur	Signification
SERVICE_ACCOUNT_FLAG_LINK_TO_HOST_ONLY 0x00000001	Aucun compte de service managé autonome n’est créé. Si un compte de service existe avec le nom spécifié, il est lié à l'ordinateur local. Cet indicateur est ignoré si le nom du compte est un compte gMSA existant.

Valeur retournée

Si la fonction réussit, elle retourne STATUS_SUCCESS.

Si la fonction échoue, elle retourne un code d'erreur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	lmaccess.h
DLL	Netapi32.dll

Voir aussi

NetEnumerateServiceAccounts

NetIsServiceAccount

NetRemoveServiceAccount

Partager via