Compartir a través de


Función NetAddServiceAccount (lmaccess.h)

La función NetAddServiceAccount crea una cuenta de servicio administrada independiente (sMSA) o recupera las credenciales de una cuenta de servicio administrada de grupo (gMSA) y almacena la información de la cuenta en el equipo local.

Esta función no tiene ninguna biblioteca de importación asociada. Debe usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Logoncli.dll.

Windows Server 2008 R2: Al instalar una cuenta de servicio administrada mediante el cmdlet de la interfaz de la línea de comandos de PowerShell para llamar a esta función, se produce un error en el código de error 0xC0000225 cuando el valor del parámetro AccountName no coincide con el nombre correspondiente del Administrador de cuentas de seguridad (SAM) de la cuenta.

Syntax

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

Parámetros

[in, optional] ServerName

El valor de este parámetro debe ser NULL.

[in] AccountName

Nombre de la cuenta que se va a crear.

[in] Password

Este parámetro está reservado. No lo utilice.

[in] Flags

Este parámetro puede ser el siguiente valor.

Importancia Meaning
SERVICE_ACCOUNT_FLAG_LINK_TO_HOST_ONLY
0x00000001
No se crea ninguna cuenta de servicio administrada independiente. Si existe una cuenta de servicio con el nombre especificado, está vinculada al equipo local. Esta marca se omite si el nombre de la cuenta es una gMSA existente.

Valor devuelto

Si la función se ejecuta correctamente, devuelve STATUS_SUCCESS.

Si se produce un error en la función, devuelve un código de error.

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo admitido Windows Server 2008 R2 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
Header lmaccess.h
Library mincore.lib
DLL de Netapi32.dll

Consulte también

NetEnumerateServiceAccounts

NetIsServiceAccount

NetRemoveServiceAccount