Partager via


_com_ptr_t::CreateInstance

Section spécifique à Microsoft

Crée une nouvelle instance d'un objet avec un CLSID ou ProgID.

HRESULT CreateInstance( 
   const CLSID& rclsid, 
   IUnknown* pOuter=NULL, 
   DWORD dwClsContext = CLSCTX_ALL  
) throw( ); 
HRESULT CreateInstance( 
   LPCWSTR clsidString, 
   IUnknown* pOuter=NULL, 
   DWORD dwClsContext = CLSCTX_ALL  
) throw( ); 
HRESULT CreateInstance( 
   LPCSTR clsidStringA, 
   IUnknown* pOuter=NULL, 
   DWORD dwClsContext = CLSCTX_ALL  
) 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.

  • dwClsContext
    Contexte d'exécution du code exécutable.

  • pOuter
    Inconnu externe pour l'agrégation.

Notes

Ces fonctions membres appellent CoCreateInstance pour créer un objet COM 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.

  • CreateInstance( rclsid**,** dwClsContext )   Crée une instance d'exécution d'un objet en fonction d'un CLSID.

  • CreateInstance( clsidString**,** dwClsContext )   Crée une instance d'exécution d'un objet en fonction d'une chaîne Unicode qui contient un CLSID (commençant par « { ») ou un ProgID.

  • CreateInstance( clsidStringA**,** dwClsContext )   Crée une instance d'exécution d'un objet en fonction d'une chaîne de 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

Voir aussi

Référence

_com_ptr_t, classe