_com_ptr_t::CreateInstance

Microsoft-spezifisch

Erstellt eine neue Instanz eines Objekts, dem ein CLSID oder ProgID übergeben wurde.

Syntax

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( );

Parameter

rclsid
Das CLSID eines Objekt.

clsidString
Eine Unicode-Zeichenfolge, die entweder eine CLSID (beginnend mit "{") oder eine ProgID enthält.

clsidStringA
Eine Mehrbytezeichenfolge mit der ANSI-Codepage, die entweder eine CLSID (beginnend mit "{") oder eine ProgID enthält.

dwClsContext
Kontext für die Ausführung von ausführbarem Code.

pOuter
Die äußere Unbekannte für die Aggregation.

Hinweise

Diese Memberfunktionen rufen CoCreateInstance auf, um ein neues COM-Objekt zu erstellen, und fragen dann den Schnittstellentyp dieses intelligenten Zeigers ab. Das Zeigerergebnis wird dann innerhalb dieses _com_ptr_t-Objekts gekapselt. Release wird aufgerufen, um den Verweiszähler für den zuvor gekapselten Zeiger zu verringern. Diese Routine gibt HRESULT zurück, um einen Erfolg oder Fehler anzuzeigen.

• CreateInstance(rclsid,dwClsContext)Erstellt eine neue ausgeführte Instanz eines Objekts, dem ein CLSID übergeben wurde.

• CreateInstance(clsidString,dwClsContext)Erstellt eine neue ausgeführte Instanz eines Objekts, dem eine Unicode-Zeichenfolge übergeben wurde, die entweder CLSID (beginnend mit "{") oder ProgID enthält.

• CreateInstance(clsidStringA,dwClsContext)  Erstellt eine neue ausgeführte Instanz eines Objekts, dem eine Mehrfachzeichen-Zeichenfolge übergeben wurde, die entweder CLSID (beginnend mit "{") oder ProgID enthält. Ruft MultiByteToWideChar auf, die davon ausgeht, dass die Zeichenfolge in der ANSI-Codepage anstatt eine OEM-Codepage ist.

Ende Microsoft-spezifisch

Weitere Informationen

_com_ptr_t-Klasse