CoGetObject-Funktion (objbase.h)

  • Artikel

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