Funzione CreateFileMoniker (objbase.h)

Articolo
08/25/2023

Crea un moniker di file in base al percorso specificato.

Sintassi

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

Parametri

[in] lpszPathName

Percorso in cui si basa questo moniker.

Questo parametro può specificare un percorso relativo, un percorso UNC o un percorso basato su unità. Se si basa su un percorso relativo, il moniker risultante deve essere composto in un altro moniker di file prima che possa essere associato.

[out] ppmk

Indirizzo di una variabile puntatore IMoniker* che riceve il puntatore dell'interfaccia al nuovo moniker del file. In caso di esito positivo, la funzione ha chiamato AddRef nel moniker del file e il chiamante è responsabile della chiamata a Release. Quando si verifica un errore, il valore del puntatore dell'interfaccia è NULL.

Valore restituito

Questa funzione può restituire il valore restituito standard E_OUTOFMEMORY, nonché i valori seguenti.

Codice restituito	Descrizione
S_OK	Il moniker è stato creato correttamente.
MK_E_SYNTAX	Si è verificato un errore nella sintassi del percorso.

Commenti

CreateFileMoniker crea un moniker per un oggetto archiviato in un file. Un provider moniker (un oggetto che fornisce moniker ad altri oggetti) può chiamare questa funzione per creare un moniker per identificare un oggetto basato su file che controlla e quindi rendere il puntatore a questo moniker disponibile per altri oggetti. Un oggetto identificato da un moniker di file deve anche implementare l'interfaccia IPersistFile in modo che possa essere caricata quando un moniker di file è associato.

Quando ogni oggetto risiede nel proprio file, come in un'applicazione ole server che supporta il collegamento solo ai documenti basati su file nell'intera dimensione, i moniker dei file sono l'unico tipo di moniker necessario. Per identificare gli oggetti più piccoli di un file, il provider moniker deve usare un altro tipo di moniker (ad esempio un moniker dell'elemento) oltre ai moniker dei file, creando un moniker composito. I moniker compositi sarebbero necessari in un'applicazione ole server che supporta il collegamento a oggetti più piccoli di un documento, ad esempio sezioni di un documento o oggetti incorporati.

Un moniker di file può essere composto a destra solo di un altro moniker di file quando il primo moniker si basa su un percorso assoluto e l'altro è un percorso relativo, causando un singolo moniker di file in base alla combinazione dei due percorsi. Un moniker composto a destra di un altro moniker deve essere un perfezionamento di tale moniker e il moniker del file rappresenta l'unità di archiviazione più grande. Per identificare gli oggetti archiviati all'interno di un file, è possibile comporre altri tipi di moniker (in genere moniker di elementi) a destra di un moniker di file.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	objbase.h
Libreria	Ole32.lib
DLL	Ole32.dll
Set di API	ext-ms-win-com-ole32-l1-1-4 (introdotta in Windows 10, versione 10.0.14393)

Vedi anche

Imoniker

Condividi tramite