IMFPluginControl::SetPreferredClsid method (mfobjects.h)

Adds a class identifier (CLSID) to the preferred list or removes a CLSID from the list.

Syntax

HRESULT SetPreferredClsid(
  [in] DWORD       pluginType,
  [in] LPCWSTR     selector,
  [in] const CLSID *clsid
);

Parameters

[in] pluginType

Member of the MF_Plugin_Type enumeration, specifying the type of object.

[in] selector

The key name for the CLSID. For more information about the format of key names, see the Remarks section of IMFPluginControl.

[in] clsid

The CLSID to add to the list. If this parameter is NULL, the key/value entry specified by the selector parameter is removed from the list.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The preferred list is global to the caller's process. Calling this method does not affect the list in other process.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header mfobjects.h (include Mfidl.h)

See also

IMFPluginControl