The GetLastUsedDateTime function retrieves the last used date and time that is stored inside the encrypted license and is maintained by the ClientProtector.  This field is updated internally when the ClientProtector is invoked to perform many operations including StartUp, InputActivationCode, ValidateExpiration and others.

Syntax

HRESULT GetLastUsedDateTime ( long * LUDTYear, long * LUDTMo, long * LUDTDay, long * LUDTHour, long * LUDTMin, long * return_code ) ;

Parameters

LUDTYear

[OUT] This is (a pointer to) a numeric value which returns holding the full Gregorian UTC year in which the license was last used.
 

LUDTMo

[OUT] This is (a pointer to) a numeric value which returns holding the Gregorian UTC month in which the license was last used.
 

LUDTDay

[OUT] This is (a pointer to) a numeric value which returns holding the Gregorian UTC day on which the license was last used.
 

LUDTHour

[OUT] This is (a pointer to) a numeric value which returns holding the military UTC hour at which the license was last used.

 

LUDTMin

[OUT] This is (a pointer to) a numeric value which returns holding the UTC minute at which the license was last used.

 

return_code 

[OUT] This is (a pointer to) a numeric value that returns with a RETURNCODE that identifies the outcome of the operation.

Remarks

The GetLastUsedDateTime function retrieves the last used date and time that is stored inside the encrypted license and is maintained by the ClientProtector.  This field is updated internally when the ClientProtector is invoked to perform many operations including StartUp, InputActivationCode, ValidateExpiration and others.

Note that the date and time returned is the UTC (Universal Time Coordinated) time for the expiration, not the local time.  If you wish to convert to local time, you must do that operation in code.

If the license is not an expiring type, then the return_code parameter will return holding TRUE_NON_EXPIRY. If the license is in expire mode, the return_code parameter will return holding TRUE_EXPIRY.

Return Value

As with all COM function calls they return an HRESULT. HRESULT is a data type that is a 32-bit error or warning code. Check your compilers documentation for information on interpreting the HRESULT value.

Function Information

Exposed By Interface:	"ISSCProtector"
Exposed In COM Server Binaries:	"SSCProt.dll" and "SSCProtD.dll"