GetAccountStatus() function
- Last UpdatedJul 22, 2024
- 1 minute read
Returns the number of days until the user’s password expires.
Category
security
Syntax
Result=GetAccountStatus(Domain, UserID);
Arguments
Domain
Name of the domain or local computer in which the user account is located.
UserID
Windows user account name that is part of the local computer, workgroup, or domain.
Return value
This function also returns the following values:
|
Result |
Description |
|---|---|
|
-1 |
Account password expired |
|
-2 |
Account password never expires |
|
-3 |
Account locked out |
|
-4 |
Account disabled |
|
-5 |
Account info failed |
Remarks
Use this script function with operating system-based security. Do not use this function with the ArchestrA security mode.
If the GetAccountStatus() function is used with ArchestrA security, the script attempts to retrieve the account information directly from the domain controller. This works as long as the ArchestrA Galaxy Repository is using operating system security with the same domain.
Example(s)
Status = GetAccountStatus("Corporate_HQ","Operator");