Compartilhar via


Função NetAddServiceAccount (lmaccess.h)

A função NetAddServiceAccount cria uma sMSA (conta de serviço gerenciada) autônoma ou recupera as credenciais de uma gMSA (conta de serviço gerenciada 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 gerenciada usando o cmdlet da 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 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.

Value Meaning
SERVICE_ACCOUNT_FLAG_LINK_TO_HOST_ONLY
0x00000001
Nenhuma conta de serviço gerenciada autônoma é criada. Se existir uma conta de serviço com o nome especificado, ela será vinculada ao computador local. Esse sinalizador será ignorado se o nome da conta for um gMSA existente.

Valor de retorno

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

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

Requirements

Requirement Value
Cliente mínimo suportado Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2008 R2 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header lmaccess.h
Library mincore.lib
de DLL Netapi32.dll

Consulte também

NetEnumerateServiceAccounts

NetIsServiceAccount

NetRemoveServiceAccount