首先,这与泛型无关,但在使用泛型时更容易出现。原来在
TControl.CreateParams
中存在缓冲区溢出漏洞。如果您查看代码,您会注意到它填充了一个
TCreateParams
结构体,特别重要的是,它用当前类(
ClassName
)的名称填充了
TCreateParams.WinClassName
。不幸的是,
WinClassName
是一个仅包含
64
个字符的固定长度缓冲区,但需要包括空终止符; 因此,一个长度为
64
的
ClassName
将使该缓冲区溢出!
可以使用以下代码进行测试:
TLongWinControlClassName4567890123456789012345678901234567891234 = class(TWinControl)
end;
procedure TForm3.Button1Click(Sender: TObject);
begin
with TLongWinControlClassName4567890123456789012345678901234567891234.Create(Self) do
begin
Parent := Self;
end;
end;
这个类名恰好有64个字符长度。将它缩短一个字符,错误将消失!
当使用泛型时,这种情况发生的可能性更大,因为Delphi构造ClassName
的方式:它包括参数类型所在的单元名称,加上一个点,然后是参数类型的名称。例如,TWinControl<TWinControl, TWinControl, TWinControl>
类的ClassName
如下:
TWinControl<Controls.TWinControl,Controls.TWinControl,Controls.TWinControl>
这句话有75
个字符,超过了63
的限制。
解决方案
我采用了一个简单的错误信息,从可能生成错误的类中获取。例如从构造函数中获取如下内容:
constructor TWinControl<T, K, W>.Create(aOwner: TComponent);
begin
{$IFOPT D+}
if Length(ClassName) > 63 then raise Exception.Create('The resulting ClassName is too long: ' + ClassName);
{$ENDIF}
inherited;
end;
至少这个错误信息可以让人立即采取行动。
后续编辑,真正的解决方案
之前的解决方法(抛出一个错误)对于非泛型类并且类名非常长的情况可以运作良好;很可能可以缩短类名,使其小于63个字符。但是对于泛型类型就不是这样了:我在一个具有两个类型参数的TWinControl子类中遇到了这个问题,因此它的形式如下:
TMyControlName<Type1, Type2>
根据这个泛型类型生成具体类型的类名采用如下形式:
TMyControlName<UnitName1.Type1,UnitName2.Type2>
因此,它包括5个标识符(2个单位标识符+3个类型标识符)+5个符号(<.,.>
)。这5个标识符的平均长度需要小于12个字符,否则总长度超过63:5x12 + 5 = 65。每个标识符仅使用11-12个字符非常少,违反了最佳实践(即:使用长描述性名称,因为按键是免费的!)。在我的情况下,我根本无法将标识符缩短到那么短。
考虑到缩短ClassName
并不总是可能的,我想试图消除问题的原因(缓冲区溢出)。不幸的是,这很困难,因为错误源自TWinControl.CreateParams
,位于CreateParams
层次结构的底部。我们不能不调用inherited
,因为CreateParams
沿着继承链一直被用来构建窗口创建参数。如果不调用它,就需要复制基本TWinControl.CreateParams
中的所有代码以及中间类中的所有代码;这也不太可移植,因为任何该代码都可能随着VCL
的未来版本(或我们可能正在子类化的第三方控件的未来版本)而改变。
以下解决方案无法阻止TWinControl.CreateParams
溢出缓冲区,但使其无害,然后(当inherited
调用返回时)解决问题。我使用一个新记录(因此我可以控制布局),其中包括原始的TCreateParams
,但将其填充了大量空间以便TWinControl.CreateParams
溢出。 TWinControl.CreateParams
想要溢出多少就让它溢出,然后我读取完整的文本并使其适合记录的原始边界,还确保生成的缩短名称具有相当高的唯一性。我在WndName中包括原始ClassName的哈希值以帮助解决唯一性问题:
type
TWrappedCreateParamsRecord = record
Orignial: TCreateParams;
SpaceForCreateParamsToSafelyOverflow: array[0..2047] of Char;
end;
procedure TExtraExtraLongWinControlDescendantClassName_0123456789_0123456789_0123456789_0123456789.CreateParams(var Params: TCreateParams);
var Wrapp: TWrappedCreateParamsRecord;
Hashcode: Integer;
HashStr: string;
begin
if Length(ClassName) >= Length(Params.WinClassName) then
begin
ZeroMemory(@Wrapp, SizeOf(Wrapp));
Move(Params, Wrapp.Orignial, SizeOf(TCreateParams));
inherited CreateParams(Wrapp.Orignial);
HashCode := TEqualityComparer<string>.Default.GetHashCode(PChar(@Wrapp.Orignial.WinClassName));
HashStr := IntToHex(HashCode, 8);
Move(HashStr[1], Wrapp.Orignial.WinClassName[High(Wrapp.Orignial.WinClassName)-8], 8*SizeOf(Char));
Wrapp.Orignial.WinClassName[High(Wrapp.Orignial.WinClassName)] := #0;
Move(Wrapp.Orignial, Params, SizeOf(TCreateParams));
end
else
inherited;
end;
TWinControl.CreateParams
并从内部修复它。你已经提交了 QC 报告吗? - David Heffernan