Función CreateFileMoniker (objbase.h)

  • Artículo

Crea un moniker de archivo basado en la ruta de acceso especificada.

Sintaxis

HRESULT CreateFileMoniker(
  [in]  LPCOLESTR lpszPathName,
  [out] LPMONIKER *ppmk
);

Parámetros

[in] lpszPathName

Ruta de acceso en la que se va a basar este moniker.

Este parámetro puede especificar una ruta de acceso relativa, una ruta de acceso UNC o una ruta de acceso basada en letras de unidad. Si se basa en una ruta de acceso relativa, el moniker resultante debe estar compuesto en otro moniker de archivo para poder enlazarlo.

[out] ppmk

Dirección de una variable de puntero IMoniker* que recibe el puntero de interfaz al nuevo moniker de archivo. Cuando se ejecuta correctamente, la función ha llamado a AddRef en el moniker de archivo y el autor de la llamada es responsable de llamar a Release. Cuando se produce un error, el valor del puntero de interfaz es NULL.

Valor devuelto

Esta función puede devolver el valor devuelto estándar E_OUTOFMEMORY, así como los siguientes valores.

Código devuelto Descripción
S_OK
 El moniker se creó correctamente.
MK_E_SYNTAX
 Error en la sintaxis de la ruta de acceso.

Comentarios

CreateFileMoniker crea un moniker para un objeto almacenado en un archivo. Un proveedor de moniker (un objeto que proporciona monikers a otros objetos) puede llamar a esta función para crear un moniker para identificar un objeto basado en archivos que controla y, a continuación, hacer que el puntero a este moniker esté disponible para otros objetos. Un objeto identificado por un moniker de archivo también debe implementar la interfaz IPersistFile para que se pueda cargar cuando se enlaza un moniker de archivo.

Cuando cada objeto reside en su propio archivo, como en una aplicación de servidor OLE que admite la vinculación solo a documentos basados en archivos en su totalidad, los monikers de archivo son el único tipo de moniker necesario. Para identificar objetos más pequeños que un archivo, el proveedor de moniker debe usar otro tipo de moniker (como un moniker de elemento) además de los monikers de archivo, creando un moniker compuesto. Los monikers compuestos serían necesarios en una aplicación de servidor OLE que admita la vinculación a objetos menores que un documento (como secciones de un documento o objetos incrustados).

Un moniker de archivo se puede componer solo a la derecha de otro moniker cuando el primer moniker se basa en una ruta de acceso absoluta y el otro es una ruta de acceso relativa, lo que da lugar a un solo moniker de archivo basado en la combinación de las dos rutas de acceso. Un moniker compuesto a la derecha de otro moniker debe ser un refinamiento de ese moniker, y el moniker de archivo representa la unidad de almacenamiento más grande. Para identificar los objetos almacenados en un archivo, redactaría otros tipos de monikers (normalmente monikers de elementos) a la derecha de un moniker de archivo.

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-4 (introducido en Windows 10, versión 10.0.14393)

Consulte también

Imoniker