_com_ptr_t::GetActiveObject
Section spécifique à Microsoft
S'attache à une instance existante d'un objet doté d'un CLSID ou ProgID.
HRESULT GetActiveObject(
const CLSID& rclsid
) throw( );
HRESULT GetActiveObject(
LPCWSTR clsidString
) throw( );
HRESULT GetActiveObject(
LPCSTR clsidStringA
) throw( );
Paramètres
rclsid
CLSID d'un objet.clsidString
Chaîne Unicode qui contient un CLSID (commençant par « { ») ou un ProgID.clsidStringA
Chaîne multioctet, utilisant la page de codes ANSI, qui contient un CLSID (commençant par « { ») ou un ProgID.
Notes
Ces fonctions membres appellent GetActiveObject pour récupérer un pointeur vers un objet en cours d'exécution qui a été inscrit avec OLE, puis des requêtes pour le type d'interface de ce pointeur intelligent. Le pointeur résultant est alors encapsulé dans cet objet _com_ptr_t. Release est appelé pour décrémenter le décompte de références du pointeur précédemment encapsulé. Cette routine retourne l'objet HRESULT pour indiquer un succès ou un échec.
GetActiveObject( rclsid ) S'attache à une instance existante d'un objet doté d'un CLSID.
GetActiveObject( clsidString ) S'attache à une instance existante d'un objet doté d'une chaîne Unicode qui contient un CLSID (commençant par « { ») ou un ProgID.
GetActiveObject( clsidStringA ) S'attache à une instance existante d'un objet doté d'une chaîne à caractères multioctets qui contient un CLSID (commençant par « { ») ou un ProgID. Appelle MultiByteToWideChar, qui suppose que la chaîne figure dans la page de codes ANSI plutôt que dans une page de codes OEM.
FIN de la section spécifique à Microsoft