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

_com_ptr_t::GetActiveObject

  • Статья

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

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

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

Параметры

  • rclsid
    CLSID объекта.

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

  • clsidStringA
    Многобайтовая строка с кодовой страницей ANSI, которая содержит либо CLSID (начинается с символа "{"), либо ProgID.

Заметки

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

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

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

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

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

См. также

Ссылки

Класс _com_ptr_t