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