SHCoCreateInstance-Funktion (shlobj_core.h)

  • Artikel

[SHCoCreateInstance ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen CoCreateInstance.]

Erstellt COM-Objekte (Component Object Model), die in Shell32.dll implementiert sind.

Syntax

SHSTDAPI SHCoCreateInstance(
  [in, optional] PCWSTR      pszCLSID,
  [in, optional] const CLSID *pclsid,
  [in, optional] IUnknown    *pUnkOuter,
  [in]           REFIID      riid,
  [out]          void        **ppv
);

Parameter

[in, optional] pszCLSID

Typ: PCWSTR

Ein Zeiger auf eine Zeichenfolge, die in eine CLSID konvertiert werden soll. Wenn NULL, wird pclsid als CLSID verwendet.

[in, optional] pclsid

Typ: const CLSID*

Die zu erstellende CLSID.

[in, optional] pUnkOuter

Typ: IUnknown*

Ein Zeiger auf das äußere IUnknown. Wird für die Aggregation verwendet.

[in] riid

Typ: REFIID

Ein Verweis auf die IID der Schnittstelle, die über ppv abgerufen werden soll.

[out] ppv

Typ: void**

Wenn diese Funktion erfolgreich zurückgegeben wird, empfängt den in riid angeforderten Schnittstellenzeiger.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Es wird empfohlen, das makro IID_PPV_ARGS zu verwenden, das in Objbase.h definiert ist, um die Parameter riid und ppv zu packen. Dieses Makro stellt die richtige IID basierend auf der Schnittstelle bereit, auf die der Wert in ppv verweist, wodurch die Möglichkeit eines Codierungsfehlers in riid vermieden wird, der zu unerwarteten Ergebnissen führen könnte.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h (shlobj.h einschließen)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.0 oder höher)