Funzione NetAddServiceAccount (lmaccess.h)

Articolo
08/24/2023

La funzione NetAddServiceAccount crea un account del servizio gestito autonomo (sMSA) o recupera le credenziali per un account del servizio gestito del gruppo e archivia le informazioni sull'account nel computer locale.

Questa funzione non ha alcuna libreria di importazione associata. È necessario usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Logoncli.dll.

Windows Server 2008 R2: L'installazione di un account del servizio gestito usando il cmdlet dell'interfaccia della riga di comando di PowerShell per chiamare questa funzione non riesce con il codice di errore 0xC0000225 quando il valore del parametro AccountName non corrisponde al nome sam ( Security Accounts Manager ) corrispondente dell'account.

Sintassi

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

Parametri

[in, optional] ServerName

Il valore di questo parametro deve essere NULL.

[in] AccountName

Nome dell'account da creare.

[in] Password

Questo parametro è riservato. Non usarlo.

[in] Flags

Questo parametro può essere il valore seguente.

Valore	Significato
SERVICE_ACCOUNT_FLAG_LINK_TO_HOST_ONLY 0x00000001	Non viene creato alcun account del servizio gestito autonomo. Se esiste un account di servizio con il nome specificato, tale account viene collegato al computer locale. Questo flag viene ignorato se il nome dell'account è un gMSA esistente.

Valore restituito

Se la funzione ha esito positivo, restituisce STATUS_SUCCESS.

Se la funzione non viene completata, restituisce un codice di errore.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	lmaccess.h
DLL	Netapi32.dll

Vedi anche

NetEnumerateServiceAccounts

NetIsServiceAccount

NetRemoveServiceAccount

Condividi tramite