IRunningObjectTable::GetObject-Methode (objidl.h)
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 |
|---|---|
|
Gibt an, dass pmkObjectName in der ROT gefunden wurde und ein Zeiger abgerufen wurde. |
|
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 |