Функция 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.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 10 версии 1803 [только классические приложения] |
| Минимальная версия сервера |
Windows Server [только классические приложения] |
| Заголовок |
|
| Библиотека |
|
| DLL |
|