IMFPluginControl::GetPreferredClsidByIndex-Methode (mfobjects.h)

  • Artikel

Ruft einen Klassenbezeichner (CLSID) aus der bevorzugten Liste ab, die durch den Indexwert angegeben wird.

Syntax

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

Parameter

[in] pluginType

Member der MF_Plugin_Type-Enumeration , die den Typ des aufzuzählenden Objekts angibt.

[in] index

Der nullbasierte Index der abzurufenden CLSID.

[out] selector

Empfängt den Schlüsselnamen, der der CLSID zugeordnet ist. Der Aufrufer muss den Arbeitsspeicher für die zurückgegebene Zeichenfolge durch Aufrufen der CoTaskMemFree-Funktion freigeben. Weitere Informationen zum Format von Schlüsselnamen finden Sie im Abschnitt Hinweise von IMFPluginControl.

[out] clsid

Empfängt die CLSID am angegebenen Index.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode Beschreibung
S_OK
 Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG
 Ungültiges Argument.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)
 Der Indexparameter liegt außerhalb des Bereichs.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfobjects.h (include Mfidl.h)

Weitere Informationen

IMFPluginControl