Skip to main content

GetPasswordPolicy

Will retrieve the password policy of local machine.

Syntax​

Method ID​

#define WAAPI_MID_GET_PASSWORD_POLICY 30009

JSON Input Structure​

{
"input": {
"method": 30009
}
}

Input Properties​

This method does not require any additional parameters beyond the method ID.

JSON Output Structure​

{
"result": {
"method": 30009,
"code": number,
"timing": number,
"timestamp": string,
"password_hist_len": string,
"max_passwd_age": string,
"min_passwd_age": string,
"min_passwd_len": string,
"complexity_requirements": boolean
}
}

Output Properties​

PropertyTypeDescription
result.methodnumberThe method ID that generated this result.
result.codenumberThe result code. See Result Codes.
result.timingnumberThe measured time for the method call in milliseconds.
result.timestampstringThe timestamp in seconds of when the call was made.
result.password_hist_lenstringThe length of password history maintained
result.max_passwd_agestringThe maximum allowable password age
result.min_passwd_agestringThe minimum number of seconds that can elapse between the time a password changes and when it can be changed again
result.min_passwd_lenstringThe minimum allowable password length
result.complexity_requirementsbooleanPassword must meet complexity requirements security policy setting

Result Codes​

CodeNameDescription
0WAAPI_OKThe operation completed successfully.
note

Other codes may be returned. See the full Result Codes reference for the complete list.

Remarks​

Error Handling​

The results of this function are determined by the error code returned by the call. If successful, WAAPI_OK or a special success code will be returned. Always check both the function return value and the result.code field in the output JSON.

Examples​

Examples will be added here demonstrating the usage of this method.

See Also​


Last updated: 2026-10-01