Функция MrmDumpPriFileInMemory

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

Создает дамп файла PRI (который является двоичным) в его ЭКВИВАЛЕНТ XML (как данные в памяти), чтобы сделать его более удобочитаемым. Функция выделяет память и возвращает указатель на нее в outputXmlData. Вызовите MrmFreeMemory с тем же указателем, чтобы освободить память. Дополнительные сведения и пошаговые руководства по использованию этих API на основе сценариев см. в статье Api-интерфейсы индексирования ресурсов пакетов (PRI) и пользовательские системы сборки.

Синтаксис

HRESULT HRESULT MrmDumpPriFileInMemory(
  _In_     PCWSTR      indexFileName,
  _In_opt_ PCWSTR      schemaPriFile,
  _In_     MrmDumpType dumpType,
  _Out_    BYTE        **outputXmlData,
  _Out_    ULONG       *outputXmlSize
);

Параметры

indexFileName [in]

Тип: PCWSTR

Полный путь к файлу PRI. Это файл PRI, который будет дампирован в XML.

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

Тип: PCWSTR

Необязательный полный путь к файлу схемы (или файлу PRI, представляющего схему; см. примечания).

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 в качестве аргумента для параметра schemaPriFile.

Требования

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

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