IMoniker ::Inverse, méthode (objidl.h)
Crée un moniker qui est l’inverse de ce moniker. Lorsqu’il est composé à droite de ce moniker ou d’une structure similaire, le moniker ne compose à rien.
Syntaxe
HRESULT Inverse(
[out] IMoniker **ppmk
);
Paramètres
[out] ppmk
Adresse d’une variable pointeur IMoniker qui reçoit le pointeur d’interface vers un moniker qui est l’inverse de ce moniker. En cas de réussite, l’implémentation doit appeler AddRef sur le nouveau moniker inverse. Il incombe à l’appelant d’appeler Release. Si une erreur se produit, l’implémentation doit définir *ppmk sur NULL.
Valeur retournée
Cette méthode peut retourner les valeurs de retour standard E_OUTOFMEMORY, ainsi que les valeurs suivantes.
| Code de retour | Description |
|---|---|
|
Le moniker inverse a été retourné avec succès. |
|
La classe moniker n’a pas d’inverse. |
Remarques
L’inverse d’un moniker est analogue au répertoire « . ». dans les systèmes de fichiers MS-DOS ; le répertoire .. agit comme l’inverse de tout autre nom de répertoire, car l’ajout de .. à un nom de répertoire entraîne un chemin d’accès vide. De la même façon, l’inverse d’un moniker est généralement également l’inverse de tous les monikers de la même classe. Toutefois, ce n’est pas nécessairement l’inverse d’un moniker d’une classe différente.
L’inverse d’un moniker composite est un composite composé des inverses des composants du moniker d’origine, disposés dans l’ordre inverse. Par exemple, si l’inverse de A est Inv( A ) et que la composite de A, B et C est Comp( A, B, C ), alors
Inv( Comp( A, B, C ) ) est égal à Comp( Inv( C ), Inv( B ), Inv( A ) ).
Tous les monikers n’ont pas d’inverses. La plupart des monikers qui sont eux-mêmes des inverses, comme les anti-monikers, n’ont pas d’inverses. Les monikers qui n’ont pas d’inverse ne peuvent pas avoir des monikers relatifs formés de l’intérieur des objets qu’ils identifient à d’autres objets extérieurs.
Remarques aux appelants
Un objet qui utilise un moniker pour localiser un autre objet ne connaît généralement pas la classe du moniker qu’il utilise. Pour obtenir l’inverse d’un moniker, vous devez toujours appeler IMoniker ::Inverse plutôt que la fonction CreateAntiMoniker , car vous ne pouvez pas être certain que le moniker que vous utilisez considère un anti-moniker comme son inverse.La méthode Inverse est également appelée par l’implémentation de la méthode IMoniker ::RelativePathTo , pour faciliter la construction d’un moniker relatif.
Remarques aux implémenteurs
Si vos monikers n’ont pas de structure interne, vous pouvez appeler la fonction CreateAntiMoniker dans pour obtenir un anti-moniker dans votre implémentation de IMoniker ::Inverse. Dans votre implémentation de IMoniker ::ComposeWith, vous devez case activée pour l’inverse que vous fournissez dans l’implémentation de Inverse.Notes spécifiques à l’implémentation
| Implémentation | Notes |
|---|---|
| Anti-moniker | Cette méthode retourne MK_E_NOINVERSE et définit *ppmk sur NULL. |
| Moniker de classe | Cette méthode retourne un anti-moniker (c’est-à-dire les résultats de l’appel de CreateAntiMoniker). |
| Moniker de fichier | Cette méthode retourne un anti-moniker (c’est-à-dire les résultats de l’appel de CreateAntiMoniker). |
| Moniker composite générique | Cette méthode retourne un moniker composite qui se compose des inverses de chacun des composants du composite d’origine, stockés dans l’ordre inverse. Par exemple, si l’inverse de A est Inv( A ), l’inverse du composite de A, B et C est Comp(Inv( C ), Inv( B ), Inv( A ) ). |
| Moniker d’élément | Cette méthode retourne un anti-moniker (c’est-à-dire les résultats de l’appel de CreateAntiMoniker). |
| MONIKER OBJREF | Cette méthode retourne un anti-moniker (c’est-à-dire les résultats de l’appel de CreateAntiMoniker). |
| Moniker de pointeur | Cette méthode retourne un anti-moniker (c’est-à-dire les résultats de l’appel de CreateAntiMoniker). |
| Moniker d’URL | Cette méthode retourne MK_E_NOINVERSE et définit *ppmk sur NULL. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | objidl.h |