NetRemoveServiceAccount, fonction (lmaccess.h)

  • Article

La fonction NetRemoveServiceAccount supprime le compte de service spécifié de la base de données Active Directory si le compte est un compte de service managé autonome (sMSA). Pour les comptes de service managés de groupe (gMSA), cette fonction ne supprime pas le compte de la base de données Active Directory. Le secret stocké dans l’autorité de sécurité locale (LSA) est supprimé à la fois pour les sMSAs et les gMSAs, et l’état est stocké dans le magasin du Registre Netlogon.

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

Syntaxe

NTSTATUS NetRemoveServiceAccount(
  [in, optional] LPWSTR ServerName,
  [in]           LPWSTR AccountName,
  [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 supprimé.

[in] Flags

Ce paramètre peut avoir la valeur suivante.

Valeur Signification
SERVICE_ACCOUNT_FLAG_UNLINK_FROM_HOST_ONLY
0x00000001
 Pour les sMSA, l’objet de compte de service est dissocié de l’ordinateur local et le secret stocké dans l’authentification LSA est supprimé. L'objet compte de service n'est pas supprimé de la base de données Active Directory. Cet indicateur n’a aucune signification pour les gMSA.

Valeur retournée

Si la fonction réussit, elle retourne STATUS_SUCCESS.

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

Spécifications

   
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

NetAddServiceAccount

NetEnumerateServiceAccounts

NetIsServiceAccount