Путаница в параметрах №2а

Это перевод Parameter confusion #2a. Автор: Майкл Каплан.

Ранее я говорил о путанице в параметрах к функции LCMapString, когда вы используете её для создания ключей сортировки, а также о путанице в параметрах к GetLocaleInfo, когда она возвращала числа.

Возможно, это просто так кажется.

Конечно же, я забыл об одном случае в этом втором посте - LOCALE_FONTSIGNATURE. Этот конкретный тип информации описан так:

LOCALE_FONTSIGNATURE
Windows 95/98/Me, Windows NT 4.0 и выше: битовая маска, используемая для определения отношения между покрытием символами, необходимом для поддержки локали и возможностями шрифта. Эта информация возвращается в записи LOCALESIGNATURE.

Я особенно горжусь выделенным красным куском текста, поскольку он был добавлен из-за моего баг-отчёта :-)

В любом случае, если вы посмотрите на объявления записей, то вы увидите что TLocaleSignature вроде как технически содержит TFontSignature:

type
  TFontSignature= packed record
    fsUsb: array[0..3] of DWORD;
    fsCsb: array[0..1] of DWORD;
  end;
  PFontSignature = ^TFontSignature;

  TLocaleSignature = packed record
    lsUsb: array[0..3] of DWORD;
    lsCsbDefault: array[0..1] of DWORD;
    lsCsbSupported: array[0..1] of DWORD;
  end;
  PLocaleSignature = ^TLocaleSignature;

Конечно же, если вы попробуете передать размер TFontSignature, говоря что это размер TLocaleSignature, которую ожидает функция, то ничего не получится, и вы получите ошибку переполнения буфера.

Да, очевидно, это отстой.

Я лично проводил разбор кода одного разработчика, который допустил эту ошибку - вот почему я протолкнул это добавление в документацию :-)

Итак, следуя принципам второго поста про путаницу в параметрах, cchDest всё ещё ожидает размер в символах, что означает, что передаваемый размер в этом случае будет SizeOf(TLocaleSignature) div SizeOf(Char), а в буфере окажется запись TLocaleSignature, которую придётся приводить от строки, чтобы компилятор был счастлив.

Просто ещё немного о путанице в параметрах для субботнего утра...

This post brought to you by "ޟ" (U+079f, a.k.a. THAANA LETTER DAADHU)