IMFPluginControl::GetPreferredClsidByIndex method

Gets a class identifier (CLSID) from the preferred list, specified by index value.

Syntax

HRESULT GetPreferredClsidByIndex(
  DWORD  pluginType,
  DWORD  index,
  LPWSTR *selector,
  CLSID  *clsid
);

Parameters

pluginType

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

index

The zero-based index of the CLSID to retrieve.

selector

Receives the key name associated with the CLSID. The caller must free the memory for the returned string by calling the CoTaskMemFree function. For more information about the format of key names, see the Remarks section of IMFPluginControl.

clsid

Receives the CLSID at the specified index.

Return Value

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

Return code Description
S_OK
The method succeeded.
E_INVALIDARG
Invalid argument.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)
The index parameter is out of range.

Requirements

   
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