Форматирование строк

Строка формата — это интерпретируемый маркер, который понимает подсистема NDR. Строки форматирования часто называются MOP (методы объектно-ориентированного программирования); в этой документации термин "строка формата" используется на протяжении всей документации.

Чтобы быть более точным, символ формата является отдельным (атомарным) интерпретируемым маркером. Каждый символ формата — один байт в размере. Строка формата — это последовательность символов формата или символов форматирования и числовых данных. Дескриптор термина также используется для именования общих последовательностей; Например, строка формата параметров или дескриптор параметров — это строка формата, используемая для описания параметра подпрограммы.

Форматные символы имеют интуитивно понятные имена, такие как FC_LONG или FC_STRUCT. Все символы строки форматирования, используемые MIDL и подсистемой NDR, определяются в файле Ndrtypes.h.

Форматирование строковых таблиц

Две основные таблицы строковых форматов используются подсистемой: таблица строкового формата процедуры, __MIDL_ProcFormatString, которая сохраняет дескрипторы процедур; и таблица строкового формата типа, __MIDL_TypeFormatString, которая сохраняет дескрипторы типов данных. Компилятор создает оба файла в основные заглушки (*_c.c, *_s.c, *_p.c). Таблица строк процедуры используется в основном различными интерпретаторами, но она также используется для преобразования буфера независимо от режима компилятора. Таблица строк формата типов используется при вызове ядра NDR для указания конкретных типов данных для работы.

Форматирование нотации строк

Нотация, используемая в этом документе, соответствует общим рекомендациям по программированию с панелью (|), используемой для обозначения альтернативных конструкций и квадратных скобок ([ ] ), используемых для обозначения необязательных элементов. Строки форматирования часто располагаются друг за другом для удобства чтения (наглядности). В этом документе FC обозначает один символ формата. Символы форматирования представлены во всех CAPS, используя их фактические символьные имена. Другие произвольные поля представлены именем и размером.

Угловые скобки (<>) используются для обозначения размеров дескрипторов. Используются соглашения, показанные в следующей таблице.

Нотация	Значение
< n>	Размер дескриптора составляет n байтов.
<>	Размер дескриптора изменяется.
{<>}*	Дескриптор повторяется любое количество раз (0,1,2 ...).

 

Следующие символы формата имеют особое значение.

Характер	Значение
FC_END	Указывает конец некоторых строк формата.
FC_PAD	Неинтерпретированный символ пад.