Méthode IMFPluginControl ::GetPreferredClsidByIndex (mfobjects.h)

Obtient un identificateur de classe (CLSID) à partir de la liste préférée, spécifiée par la valeur d’index.

Syntaxe

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

Paramètres

[in] pluginType

Membre de l’énumération MF_Plugin_Type , spécifiant le type d’objet à énumérer.

[in] index

Index de base zéro du CLSID à récupérer.

[out] selector

Reçoit le nom de clé associé au CLSID. L’appelant doit libérer la mémoire de la chaîne retournée en appelant la fonction CoTaskMemFree . Pour plus d’informations sur le format des noms de clés, consultez la section Remarques de IMFPluginControl.

[out] clsid

Reçoit le CLSID à l’index spécifié.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
S_OK
E_INVALIDARG
Argument non valide.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)
Le paramètre d’index est hors de la plage.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mfobjects.h (inclure Mfidl.h)

Voir aussi

IMFPluginControl