BindMoniker
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função localiza um objeto by means of o moniker, ativa o objeto se ele estiver inativo e recupera um ponteiro para a interface especificado desse objeto.
Syntax
HRESULT BindMoniker(
LPMONIKER pmk,
DWORD grfOpt,
REFIID iidResult,
LPVOID FAR* ppvResult
);
Parameters
- PMK
[no] Ponteiro para moniker do objeto.
- grfOpt
[no] Reservado para uso futuro; Deve ser zero.
- iidResult
[no] Interface identificador a ser usado para se comunicar com o objeto.
ppvResult
[out] Endereço do ponteiro variável que recebe o ponteiro interface solicitado no iidResult.Após bem-sucedido retornar *ppvResult Contém o ponteiro interface solicitada.
Se ocorrer um erro *ppvResult é NULL.
Se for o chamar bem-sucedido, o chamador é responsável por liberar o ponteiro com um chamar para do o objeto IUnknown::Release.
Return Value
- S_OK
O objeto foi localizado e ativado, se necessário, e que um ponteiro para a interface solicitada foi retornado.
- MK_E_NOOBJECT
O objeto que o objeto moniker identificado não foi encontrado.
Essa função também pode retornar qualquer um dos valores de erro retornados pelo IMoniker::BindToObject método.
Remarks
BindMoniker é um função de ajuda fornecido como uma maneira conveniente de um cliente que possui o moniker de um objeto para obter um ponteiro para uma das suas interfaces. O BindMoniker função pacotes chamadas para CreateBindCtx e BindToObject.
CreateBindCtx Cria um objeto contexto BIND que ofereça suporte a implementação do sistema IBindContext. O PMK parâmetro é realmente um ponteiro para o IMoniker implementação em um objeto moniker. Dessa implementação BindToObject método fornece o ponteiro para o ponteiro interface solicitada.
Se você tiver vários identificadores de origem para BIND em rápido sucessão, e se você souber que essas monikers ativará o mesmo objeto, ele pode ser mais eficiente para chamar o IMoniker::BindToObject método diretamente, que lhe permite usar o mesmo objeto contexto BIND para todos os identificadores de origem. Veja a seção IBindCtx interface para obter mais informações.
Aplicativos recipiente que permitem que seus documentos para conter os objetos vinculados são um cliente especial que geralmente não faz chamadas direcionar para IMoniker Métodos. Em vez disso, o cliente manipula os objetos vinculados por meio de IOleLink interface.
O manipulador usar como padrão implementa essa interface e chama o apropriado IMoniker Métodos quando necessário.
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 |