Método IMoniker::Inverse (objidl.h)
Crea un moniker que es el inverso de este moniker. Cuando se compone a la derecha de este moniker o de una estructura similar, el moniker no se compone de nada.
Sintaxis
HRESULT Inverse(
[out] IMoniker **ppmk
);
Parámetros
[out] ppmk
Dirección de una variable de puntero IMoniker que recibe el puntero de interfaz a un moniker que es el inverso de este moniker. Cuando se ejecuta correctamente, la implementación debe llamar a AddRef en el nuevo moniker inverso. Es responsabilidad del autor de la llamada llamar a Release. Si se produce un error, la implementación debe establecer *ppmk enNULL.
Valor devuelto
Este método puede devolver los valores devueltos estándar E_OUTOFMEMORY, así como los valores siguientes.
| Código devuelto | Descripción |
|---|---|
|
El moniker inverso se ha devuelto correctamente. |
|
La clase moniker no tiene un inverso. |
Comentarios
El inverso de un moniker es análogo al directorio ".." en sistemas de archivos MS-DOS; el directorio ".." actúa como inverso a cualquier otro nombre de directorio, ya que anexa ".." a un nombre de directorio da como resultado una ruta de acceso vacía. De la misma manera, el inverso de un moniker normalmente también es el inverso de todos los monikers de la misma clase. Sin embargo, no es necesariamente el inverso de un moniker de una clase diferente.
El inverso de un moniker compuesto es un compuesto formado por los inversos de los componentes del moniker original, organizados en orden inverso. Por ejemplo, si el inverso de A es Inv( A ) y la composición de A, B y C es Comp( A, B, C ), entonces
Inv( Comp( A, B, C ) es igual a Comp( Inv( C ), Inv( B ), Inv( A ) ).
No todos los monikers tienen inversos. La mayoría de los monikers que son inversos, como los anti-monikers, no tienen inversos. Los monikers que no tienen ningún monikers inverso no pueden tener monikers relativos formados desde dentro de los objetos que identifican a otros objetos fuera.
Notas a los autores de llamadas
Un objeto que usa un moniker para buscar otro objeto normalmente no conoce la clase del moniker que está usando. Para obtener el inverso de un moniker, siempre debe llamar a IMoniker::Inverse en lugar de la función CreateAntiMoniker , ya que no puede estar seguro de que el moniker que está usando considera que un anti-moniker es su inverso.La implementación del método IMoniker::RelativePathTo también llama al método Inverso para ayudar a construir un moniker relativo.
Notas para los implementadores
Si los monikers no tienen ninguna estructura interna, puede llamar a la función CreateAntiMoniker en para obtener un anti-moniker en la implementación de IMoniker::Inverse. En la implementación de IMoniker::ComposeWith, debe comprobar el inverso que proporcione en la implementación de Inverso.Notas específicas de la implementación
| Implementación | Notas |
|---|---|
| Anti-moniker | Este método devuelve MK_E_NOINVERSE y establece *ppmk enNULL. |
| Moniker de clase | Este método devuelve un anti-moniker (es decir, los resultados de llamar a CreateAntiMoniker). |
| Moniker de archivo | Este método devuelve un anti-moniker (es decir, los resultados de llamar a CreateAntiMoniker). |
| Moniker compuesto genérico | Este método devuelve un moniker compuesto que consta de los inversos de cada uno de los componentes del compuesto original, almacenados en orden inverso. Por ejemplo, si el inverso de A es Inv( A ), el inverso de la composición de A, B y C es Comp(Inv( C ), Inv( B ), Inv( A ) ). |
| Moniker de elemento | Este método devuelve un anti-moniker (es decir, los resultados de llamar a CreateAntiMoniker). |
| Moniker de OBJREF | Este método devuelve un anti-moniker (es decir, los resultados de llamar a CreateAntiMoniker). |
| Moniker de puntero | Este método devuelve un anti-moniker (es decir, los resultados de llamar a CreateAntiMoniker). |
| Moniker de dirección URL | Este método devuelve MK_E_NOINVERSE y establece *ppmk enNULL. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | objidl.h |