Função NetRemoveServiceAccount (lmaccess.h)

Artigo
08/24/2023

A função NetRemoveServiceAccount excluirá a conta de serviço especificada do banco de dados do Active Directory se a conta for uma sMSA (conta de serviço gerenciada autônoma). Para gMSAs (contas de serviço gerenciado de grupo), essa função não exclui a conta do banco de dados do Active Directory. O segredo armazenado na LSA ( Autoridade de Segurança Local ) é excluído para sMSAs e gMSAs, e o estado é armazenado no repositório do Registro netlogon.

Essa função não tem biblioteca de importação associada. Você deve usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Logoncli.dll.

Sintaxe

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

Parâmetros

[in, optional] ServerName

O valor desse parâmetro deve ser NULL.

[in] AccountName

O nome da conta a ser excluída.

[in] Flags

Esse parâmetro pode ter o valor a seguir.

Valor	Significado
SERVICE_ACCOUNT_FLAG_UNLINK_FROM_HOST_ONLY 0x00000001	Para sMSAs, o objeto de conta de serviço é desvinculado do computador local e o segredo armazenado na LSA é excluído. O objeto da conta de serviço não é excluído do banco de dados do Active Directory. Esse sinalizador não tem significado para gMSAs.

Valor retornado

Se a função for bem-sucedida, ela retornará STATUS_SUCCESS.

Se a função falhar, será exibido um código de erro.

Requisitos


Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	lmaccess.h
DLL	Netapi32.dll

Confira também

NetAddServiceAccount

NetEnumerateServiceAccounts

NetIsServiceAccount

Compartilhar via