Función CreateAntiMoniker (objbase.h)
Crea y devuelve un nuevo anti-moniker.
Sintaxis
HRESULT CreateAntiMoniker(
[out] LPMONIKER *ppmk
);
Parámetros
[out] ppmk
Dirección de una variable de puntero IMoniker* que recibe el puntero de interfaz al nuevo anti-moniker. Cuando se ejecuta correctamente, la función ha llamado a AddRef en el anti-moniker y el autor de la llamada es responsable de llamar a Release. Cuando se produce un error, el puntero anti-moniker es NULL.
Valor devuelto
Esta función puede devolver los valores devueltos estándar E_OUTOFMEMORY y S_OK.
Comentarios
Llamaría a esta función solo si está escribiendo su propia clase de moniker (implementando la interfaz IMoniker ). Si está escribiendo una nueva clase de moniker que no tiene ninguna estructura interna, puede usar CreateAntiMoniker en la implementación del método IMoniker::Inverse y, a continuación, comprobar si hay un anti-moniker en la implementación de IMoniker::ComposeWith.
Al igual que el directorio ".." que actúa como inverso a cualquier nombre de directorio justo antes de él en una ruta de acceso, un anti-moniker actúa como el inverso de un moniker simple que lo precede en un moniker compuesto. Un anti-moniker se usa como inverso de monikers simples sin estructura interna. Por ejemplo, las implementaciones proporcionadas por el sistema de monikers de archivos, monikers de elementos y monikers de puntero usan anti-monikers como su inverso; por lo tanto, un anti-moniker compuesto a la derecha de uno de estos monikers se compone de nada.
Un cliente de moniker (un objeto que usa un moniker para enlazar a otro objeto) normalmente no conoce la clase de un moniker determinado, por lo que el cliente no puede estar seguro de que un moniker anti-moniker es el inverso. Por lo tanto, para obtener el inverso de un moniker, se llamaría IMoniker::Inverso en lugar de CreateAntiMoniker.
Para quitar la última pieza de un moniker compuesto, haría lo siguiente:
- Llame a IMoniker::Enum en la composición y especifique FALSE como primer parámetro. Esto crea un enumerador que devuelve los monikers de componentes en orden inverso.
- Use el enumerador para recuperar la última parte del compuesto.
- Llame a IMoniker::Inverso en ese moniker. El moniker devuelto por Inverso quitará la última pieza del compuesto.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | objbase.h |
| Library | Ole32.lib |
| Archivo DLL | Ole32.dll |
| Conjunto de API | ext-ms-win-com-ole32-l1-1-5 (introducido en Windows 10, versión 10.0.15063) |