IMFPluginControl::GetPreferredClsidByIndex method

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

Syntax


HRESULT GetPreferredClsidByIndex(
  [in]  DWORD  pluginType,
  [in]  DWORD  index,
  [out] LPWSTR *selector,
  [out] CLSID  *clsid
);

Parameters

pluginType [in]

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

index [in]

The zero-based index of the CLSID to retrieve.

selector [out]

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 [out]

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 codeDescription
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]

Header

Mfobjects.h (include Mfidl.h)

See also

IMFPluginControl

 

 

Show: