Функция MrmDumpPriDataInMemory

[Некоторые сведения относятся к предварительно выпущенным продуктам, которые могут быть существенно изменены до его коммерческого выпуска. Майкрософт не дает никаких гарантий, явных или подразумеваемых, в отношении предоставленной здесь информации.]

Создает дампы сведений PRI (в виде большого двоичного объекта в памяти, созданного при предыдущем вызове MrmCreateResourceFileInMemory) в xml-эквивалент (как данные в памяти), чтобы сделать его более удобочитаемым. Функция выделяет память и возвращает указатель на нее в outputXmlData. Вызовите MrmFreeMemory с тем же указателем, чтобы освободить память. Дополнительные сведения и пошаговые руководства по использованию этих API на основе сценариев см. в статье Api-интерфейсы индексирования ресурсов пакетов (PRI) и пользовательские системы сборки.

Синтаксис

HRESULT HRESULT MrmDumpPriDataInMemory(
  _In_     BYTE        *inputPriData,
  _In_     ULONG       inputPriSize,
  _In_opt_ BYTE        *schemaPriData,
  _In_     ULONG       schemaPriSize,
  _In_     MrmDumpType dumpType,
  _Out_    BYTE        **outputXmlData,
  _Out_    ULONG       *outputXmlSize
);

Параметры

inputPriData [in]

Тип: BYTE*

Указатель на данные PRI, созданные при предыдущем вызове MrmCreateResourceFileInMemory.

inputPriSize [in]

Тип: ULONG

Размер данных, на которые указывает inputPriData.

schemaPriData [in, необязательный]

Тип: BYTE*

Необязательный указатель на сведения PRI (как большой двоичный объект в памяти), представляющий данные схемы, созданные при предыдущем вызове MrmCreateResourceFileInMemory. Не освобождайте schemaPriData до завершения работы с индексатором ресурсов. См. также примечания.

schemaPriSize [in]

Тип: ULONG

Размер данных, на которые указывает schemaPriData.

dumpType [in]

Тип: MrmDumpType

Указывает, насколько подробным должен быть дамп XML и следует ли создать дамп схемы.

outputXmlData [out]

Тип: BYTE**

Адрес указателя на BYTE. Функция выделяет память и возвращает указатель на нее в outputXmlData. Вызовите MrmFreeMemory с помощью указателя на BYTE, чтобы освободить память.

outputXmlSize [out]

Тип: ULONG*

Адрес ULONG. В outputXmlSize функция возвращает размер выделенной памяти, на которую указывает outputXmlData.

Возвращаемое значение

Тип: HRESULT

S_OK, если функция выполнена успешно, в противном случае — другое значение. Используйте макросы SUCCEEDED() или FAILED() (определенные в winerror.h) для определения успеха или сбоя.

Комментарии

Пакет ресурсов без схемы создается с помощью аргумента MrmPackagingOptionsOmitSchemaFromResourcePacks , переданного в MrmCreateResourceFile или MrmCreateResourceFileInMemory (или с параметром omitSchemaFromResourcePacks в файле конфигурации PRI). Чтобы создать дамп пакета ресурсов без схемы, передайте путь к данным PRI пакета main в качестве аргумента для параметра schemaPriData.

Требования

См. также раздел

Интерфейсы API индексирования ресурсов пакета (PRI) и пользовательские системы сборки