Создание учетной записи компьютера

В следующем примере кода показано, как создать учетную запись компьютера с помощью функции NetUserAdd.

Ниже приведены рекомендации по управлению учетными записями компьютеров.

• Имя учетной записи компьютера должно быть всем верхним регистром для согласованности с служебными программами управления учетными записями.
• Имя учетной записи компьютера всегда имеет конечный знак доллара ($). Все функции, используемые для управления учетными записями компьютеров, должны создавать имя компьютера таким образом, чтобы последний символ имени учетной записи компьютера был знаком доллара ($). Для доверия между доменами имя учетной записи — TrustingDomainName$.
• Максимальная длина имени компьютера составляет MAX_COMPUTERNAME_LENGTH (15). Эта длина не включает конечный символ доллара ($).
• Пароль для новой учетной записи компьютера должен быть нижним регистром имени учетной записи компьютера без конечного знака доллара ($). Для доверия между доменами пароль может быть произвольным значением, которое соответствует значению, указанному на стороне доверия связи.
• Максимальная длина пароля составляет LM20_PWLEN (14). Пароль должен быть усечен до этой длины, если имя учетной записи компьютера превышает эту длину.
• Пароль, предоставленный во время создания учетной записи компьютера, действителен только до тех пор, пока учетная запись компьютера не станет активной в домене. Новый пароль устанавливается во время активации отношений доверия.

#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;
    }
}

Пользователь, вызывающий функции управления учетными записями, должен иметь права администратора на целевом компьютере. В случае существующих учетных записей компьютеров создатель учетной записи может управлять учетной записью независимо от административного членства. Дополнительные сведения о вызовах функций, требующих прав администратора, см. в разделе Запуск с специальными привилегиями.

SeMachineAccountPrivilege можно предоставить на целевом компьютере, чтобы предоставить указанным пользователям возможность создавать учетные записи компьютерных систем. Это дает неадминистраторам возможность создавать компьютерные учетные записи. Пользователь должен включить эту привилегию перед добавлением учетной записи компьютера. Дополнительные сведения о привилегиях учетной записи см. в Привилегии и Константы авторизации .