CreateItemMoniker

9/8/2008

Essa função cria um moniker item que identifica um objeto em um objeto contendo (geralmente um documento composto).

Syntax

WINOLEAPI CreateItemMoniker(
  LPCOLESTR lpszDelim,
  LPCOLESTR lpszItem,
  LPMONIKER FAR* ppmk
);

Parameters

• lpszDelim
  [in] Pointer to a wide character string (two bytes per character) zero-terminated string containing the delimiter (typically "!") used to separate this item's display name from the display name of its containing object.

• lpszItem
  [no] Ponteiro para uma seqüência de caracteres zero-Terminated indicando Nome do objeto de recipiente para o objeto que está sendo identificado. Esse nome pode posteriormente ser usado para recuperar um ponteiro para o objeto em um chamar para IOleItemContainer::GetObject.

• ppmk
  [out] Endereço do IMonikervariável * pointer que recebe o ponteiro interface para o moniker item.

  Quando bem-sucedido, a função tem chamado IUnknown::AddRef Sobre o item moniker e o chamador é responsável por chamado IUnknown::Release.

  Se ocorrer um erro, o ponteiro interface fornecido possui um NULL valor.

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.

Remarks

Um provedor moniker, que passa fora monikers para identificar seus objetos de modo que eles seja acessível a outras partes, poderia chamar CreateItemMoniker Para identificar seus objetos com identificadores de origem item.

Item monikers são baseados em um seqüência de caracteres e identificam os objetos que estão contidos em outro objeto e podem ser identificado individualmente usando um seqüência de caracteres. O objeto recipiente também deve implementar o IOleContainer interface.

A maioria dos provedores moniker são aplicativos OLE que suporte vinculação. Aplicativos que suporte vinculando a objetos menor que documentos File-based, such as um aplicativo servidor que permite vinculação a uma seleção em um documento, deverá usar monikers item para identificar os objetos.

Os aplicativos recipientes que permitem vinculando incorporado objetos usam monikers item para identificar o incorporado objetos.

O lpszItem parâmetro é o nome usado pelo documento para identificar exclusivamente o objeto. De exemplo, se o objeto que está sendo identificado é um intervalo célula em uma planilha eletrônica, um apropriado nome pode ser algo como "A1:E7".

Um apropriado nome quando o objeto que está sendo identificado é um objeto incorporado pode ser algo como "embedobj1". O objeto que contém deve fornecer uma implementação das IOleItemContainer interface que pode interpretar esse nome e localizar o correspondente objeto. Isso permite que o moniker item seja ligado para o objeto ele identifica.

Item monikers não são usados no isolamento. Eles devem ser compostos com um moniker que identifica o objeto que contém as well.

De exemplo, se o objeto que está sendo identificado é um intervalo célula contido em um documento File-based, o moniker item identifica esse objeto deve ser composto com o moniker arquivo identificando esse documento, resultando em uma composição moniker que é o equivalente de "C:\Work\Sales.xls!A1:E7".

Recipientes aninhadas são permitidas também, as in a maiúsculas e minúsculas onde um objeto está contido em um objeto incorporado em outro documento.

O completo moniker de tal um objeto seria o equivalente de "C:\Work\Report.doc!embedobj1!A1:E7". Neste maiúsculas e minúsculas, cada objeto que contém deve chamar CreateItemMoniker e fornecer sua própria implementação da IOleItemContainer interface.

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