Função SHCreateThreadRef (shlwapi.h)

Cria uma referência por thread a um objeto COM (Component Object Model).

Sintaxe

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

Parâmetros

[in] pcRef

Tipo: LONG*

Um ponteiro para um valor, geralmente uma variável local no ThreadProc do thread, que é usado pela interface em ppunk como um contador de referência.

[out] ppunk

Tipo: IUnknown**

O endereço de um ponteiro para uma interface IUnknown . Se tiver êxito, esse parâmetro conterá o ponteiro IUnknown do thread no retorno. Seu aplicativo é responsável por liberar o ponteiro quando ele for concluído.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Consulte Gerenciando referências de thread para obter mais detalhes sobre como usar as APIs de thread Shlwapi.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
Biblioteca	Shlwapi.lib
DLL	Shlwapi.dll (versão 6.0 ou posterior)

Confira também

SHCreateThread

SHGetThreadRef

SHReleaseThreadRef

SHSetThreadRef