_com_ptr_t::GetActiveObject

Específicos de Microsoft

Se adjunta a una instancia existente de un objeto, dado CLSID o ProgID.

Sintaxis

HRESULT GetActiveObject(
   const CLSID& rclsid
) throw( );
HRESULT GetActiveObject(
   LPCWSTR clsidString
) throw( );
HRESULT GetActiveObject(
   LPCSTR clsidStringA
) 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.

Comentarios

Estas funciones miembro llaman a GetActiveObject para recuperar un puntero a un objeto actual que se ha registrado con OLE y, después, consultan 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.

• GetActiveObject(rclsid) Adjunta a una instancia existente de un objeto dado un CLSID.

• GetActiveObject(clsidString) Se adjunta a una instancia existente de un objeto, dada una cadena Unicode que contiene un CLSID (que comienza con "{") o un ProgID.

• GetActiveObject(clsidStringA) Se adjunta a una instancia existente de un objeto, dada una cadena de caracteres Unicode que contiene un CLSID (que comienza con "{") o un ProgID. 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)