SHCreateThreadRef-Funktion (shlwapi.h)

Erstellt einen Threadbezug auf ein COM-Objekt (Component Object Model).

Syntax

LWSTDAPI SHCreateThreadRef(
  [in]  LONG     *pcRef,
  [out] IUnknown **ppunk
);

Parameter

[in] pcRef

Typ: LONG*

Ein Zeiger auf einen Wert, in der Regel eine lokale Variable im ThreadProc, der von der Schnittstelle in ppunk als Verweisindikator verwendet wird.

[out] ppunk

Typ: IUnknown**

Die Adresse eines Zeigers auf eine IUnknown-Schnittstelle . Bei erfolgreicher Ausführung enthält dieser Parameter den IUnknown-Zeiger des Threads bei der Rückgabe. Ihre Anwendung ist dafür verantwortlich, den Zeiger frei zu geben, wenn er fertig ist.

Rückgabewert

Typ: HRESULT

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

Hinweise

Weitere Informationen zur Verwendung der Shlwapi-Thread-APIs finden Sie unter Verwalten von Threadverweise .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
Bibliothek	Shlwapi.lib
DLL	Shlwapi.dll (Version 6.0 oder höher)

Weitere Informationen

SHCreateThread

SHGetThreadRef

SHReleaseThreadRef

SHSetThreadRef