Udostępnij za pośrednictwem

_com_ptr_t::GetActiveObject

  • Artykuł

Specyficzne dla firmy Microsoft

Dołącza do istniejącego wystąpienia obiektu biorąc pod uwagę CLSID lub ProgID.

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

Parametry

  • rclsid
    CLSID obiektu.

  • clsidString
    Ciąg znaków Unicode, który posiada CLSID (zaczynający się od "{") lub ProgID.

  • clsidStringA
    Wielobajtowy ciąg znaków, wykorzystujący stronę kodową ANSI, który posiada CLSID (zaczynający się od "{") lub ProgID.

Uwagi

Funkcje składowe wywołują GetActiveObject w celu pobrania wskaźnika do uruchomionego obiektu, który został zarejestrowany z OLE, a następnie odpytują o typ interfejsu tego inteligentnego wskaźnika.Wynikowy wskaźnik zostaje następnie zhermetyzowany w obiekcie _com_ptr_t.Wywoływana jest funkcja Release, aby zmniejszyć licznik odwołań dla wcześniej zhermetyzowanego wskaźnika.Ta procedura zwraca HRESULT, aby określić sukces lub niepowodzenie.

  • Funkcja GetActiveObject( rclsid**)** Dołącza do istniejącego wystąpienia obiektu podany CLSID.

  • GetActiveObject (clsidString) dołącza do istniejącego wystąpienia obiektu podany ciąg Unicode, która posiada albo CLSID (zaczynający się od "{") lub ProgID.

  • GetActiveObject (clsidStringA) dołącza do istniejącego wystąpienia obiektu podany ciąg znaków wielobajtowych, który posiada albo CLSID (zaczynający się od "{") lub ProgID.Wywołuje metodę MultiByteToWideChar, która zakłada, że ciąg jest w stronie kodowej ANSI, a nie stronie kodowej OEM.

KONIEC informacji specyficznych dla firmy Microsoft

Zobacz też

Informacje

_com_ptr_t — Klasa