CoGetObject-Funktion (objbase.h)

Artikel
02/29/2024

Konvertiert einen Anzeigenamen in einen Moniker, der das Objekt mit dem Namen identifiziert, und bindet dann an das vom Moniker identifizierte Objekt.

Syntax

HRESULT CoGetObject(
  [in]           LPCWSTR   pszName,
  [in, optional] BIND_OPTS *pBindOptions,
  [in]           REFIID    riid,
  [out]          void      **ppv
);

Parameter

[in] pszName

Der Anzeigename des zu erstellenden Objekts.

[in, optional] pBindOptions

Die Bindungsoptionen, die zum Erstellen eines Monikers verwendet werden, der das tatsächliche Objekt erstellt. Ausführliche Informationen finden Sie unter BIND_OPTS. Dieser Parameter kann NULL sein.

[in] riid

Ein Verweis auf den Bezeichner einer Schnittstelle, die für das zu erstellende Objekt implementiert wird.

[out] ppv

Die Adresse eines Zeigers auf die Schnittstelle, die von riid für das erstellte Objekt angegeben wird.

Rückgabewert

Diese Funktion kann die Standardrückgabewerte E_FAIL, E_OUTOFMEMORY und E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Das Objekt wurde erfolgreich erstellt.
MK_E_SYNTAX	Der PszName-Parameter ist kein ordnungsgemäß formatierter Anzeigename.
MK_E_NOOBJECT	Das durch diesen Moniker identifizierte Objekt oder ein durch den zusammengesetzten Moniker identifiziertes Objekt, zu dem dieser Moniker gehört, konnte nicht gefunden werden.
MK_E_EXCEEDEDDEADLINE	Der Bindungsvorgang konnte nicht innerhalb des von der in pBindOptions übergebenen BIND_OPTS-Struktur angegebenen Zeitlimits abgeschlossen werden.
MK_E_CONNECTMANUALLY	Für den Bindungsvorgang ist die Unterstützung des Endbenutzers erforderlich. Die häufigsten Gründe für die Rückgabe dieses Werts sind, dass ein Kennwort erforderlich ist oder dass eine Diskette eingebunden werden muss.
MK_E_INTERMEDIATEINTERFACENOTSUPPORTED	Es wurde ein Zwischenobjekt gefunden, aber es unterstützte keine Schnittstelle, die zum Abschließen des Bindungsvorgangs erforderlich ist. Beispielsweise gibt ein Elementmoniker diesen Wert zurück, wenn sein Container die IOleItemContainer-Schnittstelle nicht unterstützt.

Hinweise

CoGetObject kapselt Aufrufe der COM-Bibliotheksfunktionen CreateBindCtx, MkParseDisplayName und IMoniker::BindToObject.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	objbase.h
Bibliothek	Ole32.lib
DLL	Ole32.dll

Weitere Informationen

BIND_OPTS

Freigeben über