IMFPluginControl::GetPreferredClsid-Methode (mfobjects.h)

Durchsucht die bevorzugte Liste nach einem Klassenbezeichner (CLSID), der mit einem angegebenen Schlüsselnamen übereinstimmt.

Syntax

HRESULT GetPreferredClsid(
  [in]  DWORD   pluginType,
  [in]  LPCWSTR selector,
  [out] CLSID   *clsid
);

[in] pluginType

Member der MF_Plugin_Type-Enumeration , der den Typ des Objekts angibt.

[in] selector

Der zu übereinstimmende Schlüsselname. Weitere Informationen zum Format von Schlüsselnamen finden Sie im Abschnitt Hinweise von IMFPluginControl.

[out] clsid

Empfängt eine CLSID aus der bevorzugten Liste.

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_NOT_FOUND)	Es wurde keine CLSID gefunden, die mit diesem Schlüssel übereinstimmt.

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)