CreateGenericComposite, fonction (objbase.h)

Effectue une composition générique de deux monikers et fournit un pointeur vers le moniker composite résultant.

Syntaxe

HRESULT CreateGenericComposite(
  [in, optional] LPMONIKER pmkFirst,
  [in, optional] LPMONIKER pmkRest,
  [out]          LPMONIKER *ppmkComposite
);

Paramètres

[in, optional] pmkFirst

Pointeur vers le moniker à composer à gauche du moniker vers lequel pmkRest pointe. Peut pointer vers n’importe quel type de moniker, y compris un composite générique.

[in, optional] pmkRest

Pointeur vers le moniker à composer à droite du moniker auquel pmkFirst pointe. Peut pointer vers n’importe quel type de moniker compatible avec le type du moniker pmkRest , y compris un composite générique.

[out] ppmkComposite

Adresse d’une variable de pointeur IMoniker* qui reçoit le pointeur d’interface vers l’objet moniker composite résultant de la composition de pmkFirst et pmkRest. Cet objet prend en charge l’implémentation de moniker composite OLE d’IMoniker. En cas de réussite, la fonction a appelé AddRef sur le moniker et l’appelant est responsable de l’appel de Release. Si pmkFirst ou pmkRest ont la valeur NULL, le pointeur fourni est celui qui n’est pas NULL. Si pmkFirst et pmkRest ont la valeur NULL ou si une erreur se produit, le pointeur retourné est NULL.

Valeur retournée

Cette fonction peut retourner la valeur de retour standard E_OUTOFMEMORY, ainsi que les valeurs suivantes.

Remarques

CreateGenericComposite joint deux monikers en un seul. Les classes de moniker jointes peuvent être différentes, soumises uniquement aux règles de composition. Appelez cette fonction uniquement si vous écrivez une nouvelle classe moniker en implémentant l’interface IMoniker , dans une implémentation de IMoniker ::ComposeWith qui inclut une fonctionnalité de composition générique.

Les fournisseurs moniker doivent appeler ComposeWith pour composer deux monikers ensemble. Les implémentations de ComposeWith doivent (tout comme les implémentations OLE) tenter, lorsque cela est raisonnable pour la classe, d’effectuer d’abord des compositions non génériques, dans lesquelles deux monikers de la même classe sont combinés. Si cela n’est pas possible, l’implémentation peut appeler CreateGenericComposite pour effectuer une composition générique, qui combine deux monikers de classes différentes, dans les règles de composition. Vous pouvez définir de nouveaux types de compositions non génériques si vous écrivez une nouvelle classe moniker.

Pendant le processus de composition des deux monikers, CreateGenericComposite effectue toutes les simplifications possibles. Prenons l’exemple où pmkFirst est le moniker composite générique, A + B + C, et pmkRest est le moniker composite générique, C -1 + B -1 + Z (où C -1 est l’inverse de C). La fonction compose d’abord C à C -1, qui compose à rien. Ensuite, il compose B et B -1 à rien. Enfin, il compose de A à Z et fournit un pointeur vers le moniker composite générique, A + Z.

Configuration requise

Voir aussi

IMoniker

IMoniker ::ComposeWith