_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
) Se adjunta a una instancia existente de un objeto, dado unCLSID
.GetActiveObject(
clsidString
) Se adjunta a una instancia existente de un objeto, dada una cadena Unicode que contiene unCLSID
(que comienza con "{") o unProgID
.GetActiveObject(
clsidStringA
) Se adjunta a una instancia existente de un objeto, dada una cadena Unicode que contiene unCLSID
(que comienza con "{") o unProgID
. 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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de