Funzione SHCreateThreadRef (shlwapi.h)

Crea un riferimento per thread a un oggetto COM (Component Object Model).

Sintassi

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

Parametri

[in] pcRef

Tipo: LONG*

Puntatore a un valore, in genere una variabile locale nel ThreadProc del thread, usata dall'interfaccia in ppunk come contatore di riferimento.

[out] ppunk

Tipo: IUnknown**

Indirizzo di un puntatore a un'interfaccia IUnknown . In caso di esito positivo, questo parametro contiene il puntatore IUnknown del thread al momento della restituzione. L'applicazione è responsabile della liberazione del puntatore al termine.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Per altre informazioni sull'uso delle API del thread Shlwapi, vedere Gestione dei riferimenti ai thread.

Requisiti

Requisito Valore
Client minimo supportato Windows XP con SP2 [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlwapi.h
Libreria Shlwapi.lib
DLL Shlwapi.dll (versione 6.0 o successiva)

Vedi anche

SHCreateThread

SHGetThreadRef

SHReleaseThreadRef

SHSetThreadRef