IRunningObjectTable::GetObject

9/8/2008

Este método determina se o objeto identificado pelo moniker especificado é execução e se for, recupera um ponteiro para esse objeto. Este método procura o moniker na Running Object Table (ROT) e recupera o ponteiro registrado lá.

Syntax

HRESULT GetObject(
  IMoniker* pmkObjectName,
  IUnknown** ppunkObject 
);

Parameters

• pmkObjectName
  [no] Ponteiro para o moniker a pesquisa na Running Object TABLE.

• ppunkObject
  [out] Endereço do IUnknownvariável * pointer que recebe o ponteiro interface para a execução objeto.

  Quando bem-sucedido, chamadas de implementação AddRef Sobre o objeto; é responsabilidade do chamador para chamar Lançamento.

  Se o objeto não for execução ou se ocorre um erro, a implementação definirá *ppunkObject para NULL.

Return Value

• S_OK
  Indica que pmkObjectName Foi encontrada na ROT e um ponteiro foi retornado.

• S_FALSE
  Não há nenhuma entrada para pmkObjectName Na ROT ou que ele identifica o objeto não está mais execução (no qual maiúsculas e minúsculas, a entrada for revogada).

Remarks

Esse método verifica o ROT para o moniker especificado por pmkObjectName. Se tivesse que moniker anteriormente foi registrado com um chamar para IRunningObjectTable::Register, esse método retorna o ponteiro que foi registrado nesse tempo.

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Notas para chamadores

Geralmente, você chamar o IRunningObjectTable::GetObject método apenas se você estiver escrevendo seu próprio classe moniker (isto é, Implementando o IMoniker interface). Você geralmente chamar esse método de sua implementação de IMoniker::BindToObject.

No entanto, nem todas as implementações do IMoniker::BindToObject precisa chamar esse método.

Se você espera que o moniker ter um prefixo (indicados por um não-NULL pmkToLeft parâmetro para IMoniker::BindToObject), você não deve verificar a ROT. O motivo disso é que somente completo monikers são registrados com o ROT e se o moniker tem um prefixo, o moniker faz parte de uma composição e, portanto, não completo. Em vez disso, o moniker deve serviços solicitação a partir de objeto identificado pelo prefixo (por exemplo, o contêiner do objeto identificado por seu moniker).

Requirements

Header	objidl.h, objidl.idl
Library	ole32.lib, uuid.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

IMoniker::BindToObject