Aurora Multimedia WACI NX-22, Reference Manual & Programming Manual

Page: 102 / 174

HRESULT GetFirmwareVersion(
[out, retval] BSTR* Version
);
Parameters
Version [out, retval] A returned string of the format “DEVICE #.# DATE”, where “DEVICE” is the
name of the device, #.# represents the version number, and DATE represents the build date
for the firmware image in MMM DD YYYY format.
ValidatePassword ( Password )
Checks a password against the administrator password.
Syntax
HRESULT ValidatePassword(
[in] BSTR Password,
[out, retval]VARIANT_BOOL* Success
);
Parameters
Password [in] The password to check
Success [out, retval] TRUE if the password matches the Administrator password, and FALSE if
password does not match.
Remarks
If this function is called with an invalid password more than 25 times, then ValidatePassword will return
FALSE for the next 15 minutes, regardless of whether the password passed into subsequent calls is valid or not.
Time_GetDate ( )
Returns current time and date on the device.
Syntax
HRESULT Time_GetDate(
[out, retval] DATE* Date
);
Parameters
Date [out, retval] DATE object.
Remarks
If the returned DATE object represents a date before 1900, the returned value will be negative, signifying an
error.
The format is
[year],[month],[day],[hour],[minute],[second],[millisecond]”
February 10, 2003, 7:15PM would be represented as “2003,2,10,19,15,0,0”.
Precision is provided to the second, so the millisecond value is ALWAYS “0”.