Compartir a través de

Función CoGetObject (objbase.h)

  • Artículo

Convierte un nombre para mostrar en un moniker que identifica el objeto denominado y, a continuación, se enlaza al objeto identificado por el moniker.

Sintaxis

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

Parámetros

[in] pszName

Nombre para mostrar del objeto que se va a crear.

[in, optional] pBindOptions

Las opciones de enlace usadas para crear un moniker que crea el objeto real. Para más información, consulte BIND_OPTS. Este parámetro puede ser NULL.

[in] riid

Referencia al identificador de una interfaz que se implementa en el objeto que se va a crear.

[out] ppv

Dirección de un puntero a la interfaz especificada por riid en el objeto que se crea.

Valor devuelto

Esta función puede devolver los valores devueltos estándar E_FAIL, E_OUTOFMEMORY y E_UNEXPECTED, así como los siguientes valores.

Código devuelto Descripción
S_OK
 El objeto se creó correctamente.
MK_E_SYNTAX
 El parámetro pszName no es un nombre para mostrar formado correctamente.
MK_E_NOOBJECT
 No se encontró el objeto identificado por este moniker o algún objeto identificado por el moniker compuesto del que este moniker es parte.
MK_E_EXCEEDEDDEADLINE
 No se pudo completar la operación de enlace dentro del límite de tiempo especificado por la estructura de BIND_OPTS pasada en pBindOptions.
MK_E_CONNECTMANUALLY
 La operación de enlace requiere ayuda del usuario final. Las razones más comunes para devolver este valor son que se necesita una contraseña o que se debe montar un disquete.
MK_E_INTERMEDIATEINTERFACENOTSUPPORTED
 Se encontró un objeto intermedio, pero no admitía una interfaz necesaria para completar la operación de enlace. Por ejemplo, un moniker de elemento devuelve este valor si su contenedor no admite la interfaz IOleItemContainer .

Comentarios

CoGetObject encapsula las llamadas a las funciones de biblioteca COM CreateBindCtx, MkParseDisplayName e IMoniker::BindToObject.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado objbase.h
Library Ole32.lib
Archivo DLL Ole32.dll

Consulte también

BIND_OPTS