Funzione CoGetObject (objbase.h)

Articolo
08/25/2023

Converte un nome visualizzato in un moniker che identifica l'oggetto denominato e quindi associa all'oggetto identificato dal moniker.

Sintassi

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

Parametri

[in] pszName

Nome visualizzato dell'oggetto da creare.

[in, optional] pBindOptions

Le opzioni di associazione usate per creare un moniker che crea l'oggetto effettivo. Per informazioni dettagliate, vedere BIND_OPTS. Questo parametro può essere NULL.

[in] riid

Riferimento all'identificatore di un'interfaccia implementata nell'oggetto da creare.

[out] ppv

Indirizzo di un puntatore all'interfaccia specificata da riid nell'oggetto creato.

Valore restituito

Questa funzione può restituire i valori restituiti standard E_FAIL, E_OUTOFMEMORY e E_UNEXPECTED, nonché i valori seguenti.

Codice restituito	Descrizione
S_OK	L'oggetto è stato creato correttamente.
MK_E_SYNTAX	Il parametro pszName non è un nome visualizzato corretto.
MK_E_NOOBJECT	Impossibile trovare l'oggetto identificato da questo moniker o un oggetto identificato dal moniker composito di cui questo moniker fa parte.
MK_E_EXCEEDEDDEADLINE	Impossibile completare l'operazione di associazione entro il limite di tempo specificato dalla struttura BIND_OPTS passata in pBindOptions.
MK_E_CONNECTMANUALLY	L'operazione di associazione richiede assistenza dall'utente finale. I motivi più comuni per restituire questo valore sono che è necessaria una password o che un floppy deve essere montato.
MK_E_INTERMEDIATEINTERFACENOTSUPPORTED	È stato trovato un oggetto intermedio, ma non supportava un'interfaccia necessaria per completare l'operazione di associazione. Ad esempio, un moniker dell'elemento restituisce questo valore se il relativo contenitore non supporta l'interfaccia IOleItemContainer .

Commenti

CoGetObject incapsula le chiamate alle funzioni della libreria COM CreateBindCtx, MkParseDisplayName e IMoniker::BindToObject.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	objbase.h
Libreria	Ole32.lib
DLL	Ole32.dll

Vedi anche

BIND_OPTS

Condividi tramite