MrmCreateConfigInMemory function

[Some information relates to pre-released product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.]

Creates new, initialized PRI configuration info (as in-memory data, not as a file) defining the qualifier defaults that you specify. The function allocates memory and returns a pointer to that memory in outputXmlData. Call MrmFreeMemory with the same pointer to free that memory. For more info, and scenario-based walkthroughs of how to use these APIs, see Package resource indexing (PRI) APIs and custom build systems.

Syntax

HRESULT HRESULT MrmCreateConfigInMemory(
  _In_     MrmPlatformVersion platformVersion,
  _In_opt_ PCWSTR             defaultQualifiers,
  _Out_    BYTE               **outputXmlData,
  _Out_    ULONG              *outputXmlSize
);

Parameters

platformVersion [in]

Type: MrmPlatformVersion

The platform version (targetOsVersion) to use for the generated configuration info.

defaultQualifiers [in, optional]

Type: PCWSTR

A list of default resource qualifiers. For example, L"language-en-US_scale-100_contrast-standard"

outputXmlData [out]

Type: BYTE**

The address of a pointer to BYTE. The function allocates memory and returns a pointer to that memory in outputXmlData. Call MrmFreeMemory with your pointer to BYTE to free that memory.

outputXmlSize [out]

Type: ULONG*

The address of a ULONG. In outputXmlSize, the function returns the size of the allocated memory pointed to by outputXmlData.

Return value

Type: HRESULT

S_OK if the function succeeded, otherwise some other value. Use the SUCCEEDED() or FAILED() macros (defined in winerror.h) to determine success or failure.

Requirements

Requirement Value
Minimum supported client
Windows 10, version 1803 [desktop apps only]
Minimum supported server
Windows Server [desktop apps only]
Header
MrmResourceIndexer.h
Library
Mrmsupport.lib
DLL
Mrmsupport.dll

See also

Package resource indexing (PRI) APIs and custom build systems