Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Das Objekt wurde erfolgreich erstellt. |
|
Der PszName-Parameter ist kein ordnungsgemäß formatierter Anzeigename. |
|
Das durch diesen Moniker identifizierte Objekt oder ein durch den zusammengesetzten Moniker identifiziertes Objekt, zu dem dieser Moniker gehört, konnte nicht gefunden werden. |
|
Der Bindungsvorgang konnte nicht innerhalb des von der in pBindOptions übergebenen BIND_OPTS-Struktur angegebenen Zeitlimits abgeschlossen werden. |
|
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. |
|
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 |