Función NetAddServiceAccount (lmaccess.h)

  • Artículo

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.

Sintaxis

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.

Valor Significado
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 realiza correctamente, devuelve STATUS_SUCCESS.

Si la función presenta un error, devuelve un código de error.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado lmaccess.h
Archivo DLL Netapi32.dll

Consulte también

NetEnumerateServiceAccounts

NetIsServiceAccount

NetRemoveServiceAccount