MrmCreateResourceIndexerFromPreviousPriData function
Creates a resource indexer used to create PRI files for use in resource packages.
This function is not needed if you created the original PRI file(s) with the MrmPackagingModeStandaloneFile or MrmPackagingModeAutoSplit packaging mode. If you are building resources for an unpackaged desktop app, you cannot use this function since only stand-alone PRI files are supported for unpackaged apps.
COM must be initialized (e.g. by calling CoInitializeEx) before using this function.
Syntax
HRESULT HRESULT MrmCreateResourceIndexerFromPreviousPriData (
_In_ PCWSTR projectRoot,
_In_ MrmPlatformVersion platformVersion,
_In_opt_ PCWSTR defaultQualifiers,
_In_ BYTE *priData,
_In_ ULONG priSize,
_Inout_ MrmResourceIndexerHandle *indexer
);
Parameters
-
projectRoot [in]
-
Type: PCWSTR
The root directory from which some file paths will be computed. Typically this will be the root directory of your source project, but may differ. See File resources in MRM for more information.
-
platformVersion [in]
-
Type: MrmPlatformVersion
The platform version (targetOsVersion) to use for the generated configuration file. Most callers should just use MrmPlatformVersion_Windows10_0_0_5
-
defaultQualifiers [in, optional]
-
Type: PCWSTR
A list of default resource qualifiers. For example, "language-en-US_scale-100". For more information about qualifiers, see Qualifiers in MRM.
-
priData [in]
-
Type: BYTE*
A pointer to an in-memory PRI file. You can obtain an in-memory PRI file either by manually loading an existing PRI file from disk, or by creating it in-memory with MrmCreateResourceFileInMemory.
-
priSize [in]
-
Type: ULONG
The size of the data pointed to by priData.
-
indexer [in, out]
-
Type: MrmResourceIndexerHandle*
A pointer to a resource indexer handle. On successful return, this will contain a handle to a resource indexer. You must free the indexer via MrmDestroyIndexerAndMessages after using it.
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.
Remarks
See the Remarks section of MrmCreateResourceIndexerFromPreviousPriFile for more info, as this function is essentially the same (except it uses in-memory PRI rather than an on-disk file).
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 10, version 1803 [desktop apps only] |
| Minimum supported server |
Windows Server [desktop apps only] |
| Header |
|
| Library |
|
| DLL |
|