Função CreateFileMoniker (objbase.h)

Cria um moniker de arquivo com base no caminho especificado.

Sintaxe

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

Parâmetros

[in] lpszPathName

O caminho no qual esse moniker deve ser baseado.

Esse parâmetro pode especificar um caminho relativo, um caminho UNC ou um caminho baseado em letra de unidade. Se baseado em um caminho relativo, o moniker resultante deverá ser composto em outro moniker de arquivo antes de ser associado.

[out] ppmk

O endereço de uma variável de ponteiro IMoniker* que recebe o ponteiro de interface para o novo moniker de arquivo. Quando bem-sucedida, a função chamou AddRef no moniker de arquivo e o chamador é responsável por chamar Release. Quando ocorre um erro, o valor do ponteiro de interface é NULL.

Retornar valor

Essa função pode retornar o valor de retorno padrão E_OUTOFMEMORY, bem como os valores a seguir.

Código de retorno	Descrição
S_OK	O moniker foi criado com êxito.
MK_E_SYNTAX	Houve um erro na sintaxe do caminho.

Comentários

CreateFileMoniker cria um moniker para um objeto armazenado em um arquivo. Um provedor de moniker (um objeto que fornece monikers para outros objetos) pode chamar essa função para criar um moniker para identificar um objeto baseado em arquivo que ele controla e, em seguida, pode disponibilizar o ponteiro para esse moniker para outros objetos. Um objeto identificado por um moniker de arquivo também deve implementar a interface IPersistFile para que possa ser carregada quando um moniker de arquivo estiver associado.

Quando cada objeto reside em seu próprio arquivo, como em um aplicativo de servidor OLE que dá suporte à vinculação somente a documentos baseados em arquivo em sua totalidade, os monikers de arquivo são o único tipo de moniker necessário. Para identificar objetos menores que um arquivo, o provedor de moniker deve usar outro tipo de moniker (como um moniker de item) além de monikers de arquivo, criando um moniker composto. Monikers compostos seriam necessários em um aplicativo de servidor OLE que dá suporte à vinculação a objetos menores que um documento (como seções de um documento ou objetos inseridos).

Um moniker de arquivo pode ser composto à direita apenas de outro moniker de arquivo quando o primeiro moniker é baseado em um caminho absoluto e o outro é um caminho relativo, resultando em um único moniker de arquivo com base na combinação dos dois caminhos. Um moniker composto à direita de outro moniker deve ser um refinamento desse moniker e o moniker de arquivo representa a maior unidade de armazenamento. Para identificar objetos armazenados em um arquivo, você comporia outros tipos de monikers (geralmente monikers de item) à direita de um moniker de arquivo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	objbase.h
Biblioteca	Ole32.lib
DLL	Ole32.dll
Conjunto de APIs	ext-ms-win-com-ole32-l1-1-4 (introduzido no Windows 10, versão 10.0.14393)

Confira também

Imoniker