Share via

IRunningObjectTable::GetObject-Methode (objidl.h)

  • Artikel

Bestimmt, ob das durch den angegebenen Moniker identifizierte Objekt ausgeführt wird, und ruft einen Zeiger auf dieses Objekt ab.

Syntax

HRESULT GetObject(
  [in]  IMoniker *pmkObjectName,
  [out] IUnknown **ppunkObject
);

Parameter

[in] pmkObjectName

Ein Zeiger auf die IMoniker-Schnittstelle auf dem Moniker.

[out] ppunkObject

Ein Zeiger auf eine IUnknown-Zeigervariable , die den Schnittstellenzeiger auf das ausgeführte Objekt empfängt. Bei erfolgreicher Ausführung ruft die Implementierung AddRef für das -Objekt auf. Es liegt in der Verantwortung des Aufrufers, Release aufzurufen. Wenn das Objekt nicht ausgeführt wird oder ein Fehler auftritt, legt die Implementierung *ppunkObject auf NULL fest.

Rückgabewert

Diese Methode kann die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Gibt an, dass pmkObjectName in der ROT gefunden wurde und ein Zeiger abgerufen wurde.
S_FALSE
 Es gibt keinen Eintrag für pmkObjectName in rot, oder das objekt, das es identifiziert, wird nicht mehr ausgeführt (in diesem Fall wird der Eintrag widerrufen).

Hinweise

Diese Methode überprüft den ROT-Wert auf den moniker, der von pmkObjectName angegeben wird. Wenn dieser Moniker zuvor mit einem Aufruf von IRunningObjectTable::Register registriert wurde, gibt diese Methode den Zeiger zurück, der zu diesem Zeitpunkt registriert wurde.

Hinweise für Anrufer

Im Allgemeinen rufen Sie die IRunningObjectTable::GetObject-Methode nur auf, wenn Sie Eine eigene Monikerklasse schreiben (d. h. die Implementierung der IMoniker-Schnittstelle ). In der Regel rufen Sie diese Methode aus Ihrer Implementierung von IMoniker::BindToObject auf.

Beachten Sie jedoch, dass nicht alle Implementierungen von IMoniker::BindToObject diese Methode aufrufen müssen. Wenn Sie erwarten, dass Ihr Moniker ein Präfix hat (angegeben durch einen nicht NULL-parameterpmkToLeft zu IMoniker::BindToObject), sollten Sie rot nicht überprüfen. Der Grund dafür ist, dass nur vollständige Moniker mit rot registriert werden, und wenn Ihr Moniker ein Präfix hat, ist Ihr Moniker Teil eines zusammengesetzten und somit nicht vollständig. Stattdessen sollte Ihr Moniker Dienste von dem Objekt anfordern, das durch das Präfix identifiziert wird (z. B. der Container des Objekts, das durch Ihren Moniker identifiziert wird).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile objidl.h

Weitere Informationen

IMoniker::BindToObject

Irunningobjecttable