Creazione di un nuovo account computer

L'esempio di codice seguente illustra come creare un nuovo account computer usando la funzione NetUserAdd .

Di seguito sono riportate considerazioni per la gestione degli account computer:

• Il nome dell'account computer deve essere tutto maiuscolo per coerenza con le utilità di gestione degli account.
• Un nome dell'account computer ha sempre un segno di dollaro finale ($). Le funzioni usate per gestire gli account computer devono compilare il nome del computer in modo che l'ultimo carattere del nome dell'account computer sia un segno dollaro ($). Per l'attendibilità tra domini, il nome dell'account è TrustingDomainName$.
• La lunghezza massima del nome computer è MAX_COMPUTERNAME_LENGTH (15). Questa lunghezza non include il segno di dollaro finale ($).
• La password per un nuovo account computer deve essere la rappresentazione minuscola del nome dell'account computer, senza il segno di dollaro finale ($). Per l'attendibilità tradominio, la password può essere un valore arbitrario che corrisponde al valore specificato sul lato trust della relazione.
• La lunghezza massima della password è LM20_PWLEN (14). La password deve essere troncata a questa lunghezza se il nome dell'account computer supera questa lunghezza.
• La password fornita all'ora di creazione dell'account computer è valida solo fino a quando l'account computer diventa attivo nel dominio. Una nuova password viene stabilita durante l'attivazione della relazione di trust.

#include <windows.h>
#include <lm.h>
#pragma comment(lib, "netapi32.lib")

BOOL AddMachineAccount(
    LPWSTR wTargetComputer,
    LPWSTR MachineAccount,
    DWORD AccountType
    )
{
    LPWSTR wAccount;
    LPWSTR wPassword;
    USER_INFO_1 ui;
    DWORD cbAccount;
    DWORD cbLength;
    DWORD dwError;

    //
    // Ensure a valid computer account type was passed.
    //
    if (AccountType != UF_WORKSTATION_TRUST_ACCOUNT &&
        AccountType != UF_SERVER_TRUST_ACCOUNT &&
        AccountType != UF_INTERDOMAIN_TRUST_ACCOUNT
        ) 
    {
        SetLastError(ERROR_INVALID_PARAMETER);
        return FALSE;
    }

    //
    // Obtain number of chars in computer account name.
    //
    cbLength = cbAccount = lstrlenW(MachineAccount);

    //
    // Ensure computer name doesn't exceed maximum length.
    //
    if(cbLength > MAX_COMPUTERNAME_LENGTH) {
        SetLastError(ERROR_INVALID_ACCOUNT_NAME);
        return FALSE;
    }

    //
    // Allocate storage to contain Unicode representation of
    // computer account name + trailing $ + NULL.
    //
    wAccount=(LPWSTR)HeapAlloc(GetProcessHeap(), 0,
        (cbAccount + 1 + 1) * sizeof(WCHAR)  // Account + '$' + NULL
        );

    if(wAccount == NULL) return FALSE;

    //
    // Password is the computer account name converted to lowercase;
    //  you will convert the passed MachineAccount in place.
    //
    wPassword = MachineAccount;

    //
    // Copy MachineAccount to the wAccount buffer allocated while
    //  converting computer account name to uppercase.
    //  Convert password (in place) to lowercase.
    //
    while(cbAccount--) {
        wAccount[cbAccount] = towupper( MachineAccount[cbAccount] );
        wPassword[cbAccount] = towlower( wPassword[cbAccount] );
    }

    //
    // Computer account names have a trailing Unicode '$'.
    //
    wAccount[cbLength] = L'$';
    wAccount[cbLength + 1] = L'\0'; // terminate the string

    //
    // If the password is greater than the max allowed, truncate.
    //
    if(cbLength > LM20_PWLEN) wPassword[LM20_PWLEN] = L'\0';

    //
    // Initialize the USER_INFO_1 structure.
    //
    ZeroMemory(&ui, sizeof(ui));

    ui.usri1_name = wAccount;
    ui.usri1_password = wPassword;

    ui.usri1_flags = AccountType | UF_SCRIPT;
    ui.usri1_priv = USER_PRIV_USER;

    dwError=NetUserAdd(
                wTargetComputer,    // target computer name
                1,                  // info level
                (LPBYTE) &ui,       // buffer
                NULL
                );

    //
    // Free allocated memory.
    //
    if(wAccount) HeapFree(GetProcessHeap(), 0, wAccount);

    //
    // Indicate whether the function was successful.
    //
    if(dwError == NO_ERROR)
        return TRUE;
    else {
        SetLastError(dwError);
        return FALSE;
    }
}

L'utente che chiama le funzioni di gestione dell'account deve avere privilegi di amministratore nel computer di destinazione. Nel caso di account computer esistenti, l'autore dell'account può gestire l'account, indipendentemente dall'appartenenza amministrativa. Per altre informazioni sulla chiamata di funzioni che richiedono privilegi di amministratore, vedere Esecuzione con privilegi speciali.

SeMachineAccountPrivilege può essere concesso nel computer di destinazione per fornire agli utenti specificati la possibilità di creare account computer. Ciò consente agli amministratori non di creare account computer. Il chiamante deve abilitare questo privilegio prima di aggiungere l'account computer. Per altre informazioni sui privilegi dell'account, vedere Privilegi e costanti di autorizzazione.