Fonction SHAssocEnumHandlersForProtocolByApplication (shobjidl_core.h)

Article
03/04/2024

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)

Partager via