创建新计算机帐户

下面的代码示例演示如何使用 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，以便指定用户能够创建计算机帐户。 这使非管理员能够创建计算机帐户。 调用方需要在添加计算机帐户之前启用此权限。 有关帐户特权的详细信息，请参阅 特权 和 授权常量。