Compartilhar via


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