Condividi tramite

Funzione CoGetObject (objbase.h)

  • Articolo

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