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.

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

Confira também

Imoniker