_com_ptr_t::CreateInstance

Microsoft-spezifisch

Erstellt eine neue Instanz eines -Objekts unter CLSID ProgID Bzw. .

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
Der CLSID eines -Objekts.

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

clsidStringA
Eine Multibytezeichenfolge unter Verwendung der ANSI-Codepage, die entweder CLSID eine (beginnend mit "{") oder 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 die Verweisanzahl für den zuvor gekapselten Zeiger zu dekrementiert. Diese Routine gibt das HRESULT zurück, um einen Erfolg oder Fehler anzugeben.

  • CreateInstance( rclsid , dwClsContext ) Erstellt eine neue ausgeführte Instanz eines -Objekts, wenn ein angegeben CLSID wird.

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

  • CreateInstance( clsidStringA , dwClsContext ) Erstellt eine neue ausgeführte Instanz eines Objekts mit einer Multibyte-Zeichenfolge, die entweder CLSID eine (beginnend mit "{") oder ProgID enthält. Ruft MultiByteToWideChar auf.Dabei wird davon ausgegangen, dass sich die Zeichenfolge in der ANSI-Codepage und nicht in einer OEM-Codepage befindet.

Ende Microsoft-spezifisch

Siehe auch

_com_ptr_t-Klasse