SmsCreateAccount

The SmsCreateAccount function creates an account in the specified domain and with the specified account name and password.

int _stdcall SmsCreateAccount(
 wchar_t *pLocalServer,
 wchar_t *pAccountDomain,
 wchar_t *pAccountName,
 wchar_t *pPassword,
 wchar_t *pComment,
 int   iFlags
  );

Parameters

  • *pLocalServer
    Unicode null-terminated string of the local system name with backslashes: \\MYSYSTEM
  • *pAccountDomain
    Domain name containing the account being tested.
  • *pAccountName
    Account name being tested.
  • *pPassword
    Account password.
  • *pComment
    Account comment.
  • iFlags
    LSAAPI_ADMIN (0x10000) and/or LSAAPI_SERVICELOGON (0x20000) and/or LSAAPI_FORCE (0x80000).

Return Values

Name Value
LSAAPI_SUCCESS 0
LSAAPI_ERROR 1
LSAAPI_ACCOUNT_NOT_FOUND 2
LSAAPI_ACCESS_DENIED 5

Remarks

The account is initially created with user credentials and no service logon credentials. The caller can pass in LSAAPI_ADMIN (0x10000) and/or LSAAPI_SERVICELOGON (0x20000) to create the account with administrator and/or service logon credentials.

For accounts with trusted domains, the pAccountDomain and pLocalServer parameters should reference the domain and server in question. The trusted domain name, if present, must be removed from the account name. That is, do not submit an account string of type domain\user.

Requirements

Windows NT/2000: Requires Windows NT 4.0 or later.
Version: Requires SMS 2.0 or later.
Library: Lsaapi.lib.**
Header:** Lsaapi.h.

Did you find this information useful? Send your suggestions and comments about the documentation to smsdkdoc@microsoft.com.