_com_ptr_t::GetActiveObject
Microsoft Specific
Attaches to an existing instance of an object given a CLSID
or ProgID
.
Syntax
HRESULT GetActiveObject(
const CLSID& rclsid
) throw( );
HRESULT GetActiveObject(
LPCWSTR clsidString
) throw( );
HRESULT GetActiveObject(
LPCSTR clsidStringA
) throw( );
Parameters
rclsid
The CLSID
of an object.
clsidString
A Unicode string that holds either a CLSID
(starting with "{") or a ProgID
.
clsidStringA
A multibyte string, using the ANSI code page, that holds either a CLSID
(starting with "{") or a ProgID
.
Remarks
These member functions call GetActiveObject to retrieve a pointer to a running object that has been registered with OLE and then queries for this smart pointer's interface type. The resulting pointer is then encapsulated within this _com_ptr_t
object. Release
is called to decrement the reference count for the previously encapsulated pointer. This routine returns the HRESULT to indicate success or failure.
GetActiveObject(
rclsid
) Attaches to an existing instance of an object given aCLSID
.GetActiveObject(
clsidString
) Attaches to an existing instance of an object given a Unicode string that holds either aCLSID
(starting with "{") or aProgID
.GetActiveObject(
clsidStringA
) Attaches to an existing instance of an object given a multibyte character string that holds either aCLSID
(starting with "{") or aProgID
. Calls MultiByteToWideChar, which assumes that the string is in the ANSI code page rather than an OEM code page.
END Microsoft Specific
See also
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for