Função NetAddServiceAccount (lmaccess.h)

Artigo
03/05/2024

A função NetAddServiceAccount cria uma sMSA (conta de serviço gerenciado) autônoma ou recupera as credenciais de uma gMSA (conta de serviço gerenciado de grupo) e armazena as informações da conta no computador local.

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

Windows Server 2008 R2: A instalação de uma conta de serviço gerenciado usando o cmdlet de interface de linha de comando do PowerShell para chamar essa função falha com o código de erro 0xC0000225 quando o valor do parâmetro AccountName não corresponde ao nome do SAM ( Gerenciador de Contas de Segurança ) correspondente da conta.

Sintaxe

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

Parâmetros

[in, optional] ServerName

O valor desse parâmetro deve ser NULL.

[in] AccountName

O nome da conta a ser criada.

[in] Password

Esse parâmetro é reservado. Não o use.

[in] Flags

Esse parâmetro pode ser o valor a seguir.

Valor	Significado
SERVICE_ACCOUNT_FLAG_LINK_TO_HOST_ONLY 0x00000001	Nenhuma conta de serviço gerenciado autônoma é criada. Caso exista uma conta de serviço com um nome especificado, ela será vinculada ao computador local. Esse sinalizador será ignorado se o nome da conta for uma gMSA existente.

Retornar valor

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

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

Requisitos

Requisito	Valor
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

NetEnumerateServiceAccounts

NetIsServiceAccount

NetRemoveServiceAccount

Compartilhar via