_com_ptr_t::CreateInstance

Específicos de Microsoft

Crea una nueva instancia de un objeto dado CLSID o ProgID.

Sintaxis

HRESULT CreateInstance(
   const CLSID& rclsid,
   IUnknown* pOuter=NULL,
   DWORD dwClsContext = CLSCTX_ALL
) throw( );
HRESULT CreateInstance(
   LPCWSTR clsidString,
   IUnknown* pOuter=NULL,
   DWORD dwClsContext = CLSCTX_ALL
) throw( );
HRESULT CreateInstance(
   LPCSTR clsidStringA,
   IUnknown* pOuter=NULL,
   DWORD dwClsContext = CLSCTX_ALL
) throw( );

Parámetros

rclsid
El CLSID de un objeto.

clsidString
Cadena Unicode que contiene un CLSID (que comienza con "{") o ProgID.

clsidStringA
Cadena multibyte, en la página de códigos ANSI, que contiene un CLSID (que comienza con “{") o ProgID.

dwClsContext
Contexto para el código ejecutable.

pOuter
El desconocido externo para agregación.

Comentarios

Estas funciones de miembro llaman a CoCreateInstance para crear un nuevo objeto CM y, a continuación, consultas para el tipo de interfaz de este puntero inteligente. El puntero resultante se encapsula dentro de este objeto _com_ptr_t. Se llama a Release para disminuir el recuento de referencias del puntero previamente encapsulado. Esta rutina devuelve el HRESULT para indicar si la operación se ha realizado de forma correcta o no.

• CreateInstance (rclsid,dwClsContext) Crea una nueva instancia en ejecución de un objeto, CLSIDdado un.

• CreateInstance (clsidString,dwClsContext) Crea una nueva instancia en ejecución de un objeto, dada una cadena Unicode que contiene CLSID (a partir de " {ProgID") o.

• CreateInstance (clsidStringA,dwClsContext) Crea una nueva instancia en ejecución de un objeto a partir de una cadena de caracteres multibyte CLSID que contiene (a partir de " {ProgID") o. Llama a MultiByteToWideChar, que supone que la cadena está en la página de códigos ANSI en lugar de una página de códigos OEM.

FIN de Específicos de Microsoft

Consulte también

_com_ptr_t (Clase)