SmsGrantActAsOSRight

 

Applies To: System Center 2012 Configuration Manager, System Center 2012 Configuration Manager SP1, System Center 2012 R2 Configuration Manager

In System Center 2012 R2 Configuration Manager, the SmsGrantActAsOSRight function grants the act as operating system credentials to the specified account.

Syntax

int _stdcall SmsGrantActAsOSRight(
      wchar_t* pLocalServer, 
      wchar_t* pAccountDomain,
      wchar_t* pAccountName, 
      wchar_t* pLocalDomain
);

Parameters

• pLocalServer
  Pointer to Unicode null-terminated string of the local system name with backslashes: \\MYSYSTEM

• pAccountDomain
  Pointer to the originating domain for the user account.

• pAccountName
  Pointer to the name of the user account.

• pLocalDomain
  Pointer to the local domain name.

Return Values

Name	Value
LSAAPI_SUCCESS	0
LSAAPI_ERROR	1
LSAAPI_ACCOUNT_NOT_FOUND	2
LSAAPI_ACCESS_DENIED	5

Remarks

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.

See Also

Configuration Manager Deprecated Functions