Partager via


Fonction SHAssocEnumHandlersForProtocolByApplication (shobjidl_core.h)

Obtient une interface d’énumération qui fournit l’accès aux gestionnaires associés à un protocole donné.

Syntaxe

SHSTDAPI SHAssocEnumHandlersForProtocolByApplication(
  [in]  PCWSTR protocol,
  [in]  REFIID riid,
  [out] void   **enumHandlers
);

Paramètres

[in] protocol

Type : PCWSTR

Pointeur vers une chaîne qui spécifie le protocole.

[in] riid

Type : REFIID

Référence à l’IID de l’interface à récupérer via enumHandlers, généralement IID_IEnumAssocHandlers.

[out] enumHandlers

Type : void**

Lorsque cette méthode retourne, contient le pointeur d’interface demandé dans riid. Il s’agit généralement d’IEnumAssocHandlers.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Il est recommandé d’utiliser la macro IID_PPV_ARGS , définie dans Objbase.h, pour empaqueter les paramètres riid et enumHandlers . Cette macro fournit l’ID IID correct en fonction de l’interface pointée par la valeur dans enumHandlers, ce qui élimine la possibilité d’une erreur de codage.

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 shobjidl_core.h (inclure Shobjidl.h)
Bibliothèque Shell32.lib
DLL Shell32.dll (version 6.1 ou ultérieure)