Fonction SHCreateThreadRef (shlwapi.h)

Crée une référence par thread à un objet COM (Component Object Model).

Syntaxe

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

Paramètres

[in] pcRef

Type : LONG*

Pointeur vers une valeur, généralement une variable locale dans le ThreadProc du thread, qui est utilisé par l’interface dans ppunk comme compteur de référence.

[out] ppunk

Type : IUnknown**

Adresse d’un pointeur vers une interface IUnknown . En cas de réussite, ce paramètre contient le pointeur IUnknown du thread au retour. Votre application est chargée de libérer le pointeur lorsqu’il est terminé.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Pour plus d’informations sur l’utilisation des API de thread Shlwapi, consultez Gestion des références de thread.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlwapi.h
Bibliothèque Shlwapi.lib
DLL Shlwapi.dll (version 6.0 ou ultérieure)

Voir aussi

SHCreateThread

SHGetThreadRef

SHReleaseThreadRef

SHSetThreadRef