(SST) ShlWAPIFunctionInfo TSSTDllVerInfo.LastError Property

	(SST) ShlWAPIFunctionInfo Version 1.0

Developer Reference

Property TSSTDllVerInfo.LastError
Property that specifies the last error that occurred during the execution of the class's methods.

Scope
Public (i.e. this property can be referenced from any code, including that in other units, with access to the TSSTDllVerInfo object of interest).

Syntax
Property LastError : INTEGER READ flasterror;

Values
This property returns a signed 32-bit integer value. Typically, this value will be a Windows error code in the range between 1 (0x0000 0001) and 1815 (0x000 0717), or -1 (0xFFFF FFFF), denoting a general (alt. generic) error. However, lastly, all values are conceivable, the exact error code depending on the Windows API or Delphi SDK function that failed, the Windows version, and any modifications that may have been made in descendant classes.

Values

This property returns a signed 32-bit integer value. Typically, this value will be a Windows error code in the range between 1 (0x0000 0001) and 1815 (0x000 0717), or -1 (0xFFFF FFFF), denoting a general (alt. generic) error. However, lastly, all values are conceivable, the exact error code depending on the Windows API or Delphi SDK function that failed, the Windows version, and any modifications that may have been made in descendant classes.

Remarks
This property is a read-only property.
Read this property to determine if an error occurred during the execution of the class's methods.
Ideally, this property is queried immediately after having read the first property or having called a method that, in the event that an error is encountered, ultimately invokes method SetLastErrorCode or assigns a value to member variable flasterror directly. Although, currently, the former applies to all TSSTDllVerInfo methods, only RetResourceVersionInfoSize, RetResourceVersionInfoBuf, RetResourceVersionInfo, RetResourceFixedFileInfo, WinApiVerQueryValueStr, and WinApiGetResourceLanguageId explicitly call SetLastErrorCode to assign a value to flasterror.
In the current implementation of TSSTDllVerInfo, tne property is never reset to zero once an error has occurred and its error code assigned to member variable flasterror. That is, the last, registered error code persists until the TSSTDllVerInfo object is destroyed.

Requirements
Unit	(Declared and implemented in) SSTNewUnit.pas
Library	SSTNewUnit.dcu/SSTNewUnit.obj
Unicode	Implemented as ANSI version only.

See Also
TSSTDllVerInfo, flasterror, SetLastErrorCode, Source Code.
Windows APIs: GetLastError, SetLastError.

Document/Contents version 1.00
Page/URI last updated on April 28, 2022

Suggestions and comments mail to:
webmaster@stoelzelsoftwaretech.com