Поделиться через

_com_ptr_t::GetActiveObject

  • Статья

Блок, относящийся только к системам Майкрософт

Присоединяется к существующему экземпляру объекта, заданного или CLSID ProgID.

Синтаксис

HRESULT GetActiveObject(
   const CLSID& rclsid
) throw( );
HRESULT GetActiveObject(
   LPCWSTR clsidString
) throw( );
HRESULT GetActiveObject(
   LPCSTR clsidStringA
) throw( );

Параметры

rclsid
Объект CLSID .

clsidString
Строка Юникода, содержащая либо ( CLSID начиная с "{") или a ProgID.

clsidStringA
Многобайтовая строка, использующая кодовую страницу ANSI, которая содержит либо ( CLSID начиная с "{") или a ProgID.

Замечания

Эти функции-члены вызывают GetActiveObject , чтобы получить указатель на запущенный объект, зарегистрированный в OLE, а затем запрашивает тип интерфейса смарт-указателя. Результирующий указатель затем инкапсулируется в этот объект _com_ptr_t. Release Вызывается для уменьшения количества ссылок для инкапсулированного указателя ранее. Эта подпрограмма возвращает HRESULT, чтобы указать успешность или сбой.

  • GetActiveObject(rclsid) подключается к существующему экземпляру объекта.CLSID

  • GetActiveObject( clsidString ) подключается к существующему экземпляру объекта, заданной строкой Юникода, содержащей либо CLSID (начиная с "{") или a ProgID.

  • GetActiveObject( clsidStringA ) подключается к существующему экземпляру объекта, заданной строкой многобайтового символа, содержащей либо ( CLSID начиная с "{") или a ProgID. Вызывает MultiByteToWideChar, который предполагает, что строка находится на кодовой странице ANSI, а не на кодовой странице OEM.

Завершение блока, относящегося только к системам Майкрософт

См. также

Класс _com_ptr_t