SHCoCreateInstance-Funktion (shlobj_core.h)
[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) |