InstantiateComponentFromPackage function (comppkgsup.h)

Article
02/22/2024

Creates an instance of a class in an application package.

Syntax

HRESULT InstantiateComponentFromPackage(
  [in]  HSTRING      classId,
  [in]  HSTRING      packageFullName,
  [out] IInspectable **instance
);

Parameters

[in] classId

The class to activate in the named package.

[in] packageFullName

The full name of the package.

[out] instance

Receives an instance of the class.

Return value

The function returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code	Description
S_OK	The function succeeded.
REGDB_E_CLASSNOTREG	The class is not registered or the class is not listed under the registry key "HKEY_LOCAL_MACHINE\Software\Microsoft\MediaEngine\MediaExtensions\EME\CDMS". See remarks for more info.

Remarks

This function can only be used with packages whose "PackageFamilyName" is defined as a subkey key that is registered under the "HKEY_LOCAL_MACHINE\Software\Microsoft\MediaEngine\MediaExtensions\EME\CDMS" key.

This API should only be called in very exceptional circumstances because code installed from the application store should not be invoked from desktop applications as it is has a lower level of trust associated with it.

Requirements

Requirement	Value
Minimum supported client	Windows 8.1 [desktop apps only]
Minimum supported server	Windows Server 2012 R2 [desktop apps only]
Target Platform	Windows
Header	comppkgsup.h
Library	Comppkgsup.lib
DLL	CompPkgSup.dll

Share via