CreateAntiMoniker, fonction (objbase.h)

  • Article

Crée et retourne un nouveau anti-moniker.

Syntaxe

HRESULT CreateAntiMoniker(
  [out] LPMONIKER *ppmk
);

Paramètres

[out] ppmk

Adresse d’une variable de pointeur IMoniker* qui reçoit le pointeur d’interface vers le nouvel anti-moniker. En cas de réussite, la fonction a appelé AddRef sur l’anti-moniker et l’appelant est responsable de l’appel de Release. Lorsqu’une erreur se produit, le pointeur anti-moniker a la valeur NULL.

Valeur retournée

Cette fonction peut retourner les valeurs de retour standard E_OUTOFMEMORY et S_OK.

Remarques

Vous appelez cette fonction uniquement si vous écrivez votre propre classe moniker (implémentant l’interface IMoniker ). Si vous écrivez une nouvelle classe moniker qui n’a pas de structure interne, vous pouvez utiliser CreateAntiMoniker dans votre implémentation de la méthode IMoniker ::Inverse, puis case activée pour un anti-moniker dans votre implémentation d’IMoniker ::ComposeWith.

Comme le répertoire .. » qui agit comme l’inverse de n’importe quel nom de répertoire qui le précède dans un chemin d’accès, un anti-moniker agit comme l’inverse d’un moniker simple qui le précède dans un moniker composite. Un anti-moniker est utilisé comme inverse des monikers simples sans structure interne. Par exemple, les implémentations fournies par le système de monikers de fichiers, de monikers d’élément et de monikers de pointeur utilisent toutes des anti-monikers comme inverse ; par conséquent, un anti-moniker composé à droite de l’un de ces monikers compose à rien.

Un client moniker (un objet qui utilise un moniker pour se lier à un autre objet) ne connaît généralement pas la classe d’un moniker donné, de sorte que le client ne peut pas être sûr qu’un anti-moniker est l’inverse. Par conséquent, pour obtenir l’inverse d’un moniker, vous devez appeler IMoniker ::Inverse plutôt que CreateAntiMoniker.

Pour supprimer le dernier morceau d’un moniker composite, procédez comme suit :

  1. Appelez IMoniker ::Enum sur le composite, en spécifiant FALSE comme premier paramètre. Cela crée un énumérateur qui retourne les monikers de composant dans l’ordre inverse.
  2. Utilisez l’énumérateur pour récupérer la dernière pièce du composite.
  3. Appelez IMoniker ::Inverse sur ce moniker. Le moniker retourné par Inverse supprime la dernière pièce du composite.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête objbase.h
Bibliothèque Ole32.lib
DLL Ole32.dll
Ensemble d’API ext-ms-win-com-ole32-l1-1-5 (introduit dans Windows 10, version 10.0.15063)

Voir aussi

IMoniker