CreateFileMoniker

9/8/2008

Essa função cria um arquivo moniker baseia o caminho especificado.

Syntax

WINOLEAPI CreateFileMoniker(
  LPCOLESTR lpszPathName,
  LPMONIKER FAR* ppmk
);

Parameters

• lpszPathName
  [in] Pointer to a zero-terminated wide character string (two bytes per character) containing the path on which this moniker is based.

• ppmk
  [out] Endereço do IMonikervariável * pointer que recebe o ponteiro interface para o moniker arquivo novo. Quando bem-sucedido, a função tem chamado IUnknown::AddRef sobre o arquivo moniker e o chamador é responsável por chamado IUnknown::Release. Quando ocorre um erro, o valor do ponteiro de interface é NULL.

Return Value

Essa função suporta o padrão valor de retorno E_OUTOFMEMORY, bem como o seguinte:

• S_OK
  O moniker foi criado com êxito.

• MK_E_SYNTAX
  Erro na sintaxe de um caminho foi encontrado ao criar um moniker.

Remarks

CreateFileMoniker Cria um moniker para um objeto armazenado em um arquivo.

Um provedor moniker (um objeto que fornece monikers a outros objetos) pode chamar esta função para criar um moniker para identificar um objeto File-Based que ele controla e pode, em seguida, verifique o ponteiro para este moniker disponível a outros objetos.

Um objeto identificado por um moniker arquivo também deve implementar o IPersistFile interface para que possam ser carregados quando um moniker arquivo está ligado.

Quando cada objeto reside em seu próprio arquivo, as in um aplicativo de servidor OLE que ofereça suporte a vinculação somente a documentos File-Based em sua totalidade, identificadores de origem arquivo são o tipo somente de moniker necessário.

Para identificar objetos menor do que um arquivo, o provedor moniker deve usar outro tipo de moniker (such as moniker um item) in addition to monikers arquivo, criando uma composição moniker.

Composto monikers poderiam ser necessárias em um aplicativo servidor OLE que ofereça suporte a vinculando a objetos menor do que um documento (tais como seções de um documento ou incorporado objetos).

O lpszPathName Pode ser uma caminho relativo, um caminho UNC (de exemplo, \\server\share\path), ou uma unidade - letra - base caminho (de exemplo, c:\). Se baseia em um caminho relativo, o moniker resultante deve ser composto até outro arquivo moniker antes de ele pode ser ligado.

Moniker um arquivo pode ser composto para o direito apenas de outro arquivo moniker quando o primeiro moniker baseia-se em um caminho absoluto e o outro é um caminho relativo, resultando em um único arquivo moniker com base na combinação dos dois caminhos.

Um moniker composto para o direito de outro moniker deve ser um refinamento de que moniker, e o moniker arquivo representa a unidade maior de armazenamento. Para identificar objetos armazenados em um arquivo, você pode compor outros tipos de identificadores de origem (geralmente monikers item) para o direito de um arquivo moniker.

Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.

Requirements

Header	objbase.h
Library	ole32.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

COM Functions