Функция SHCreateThreadRef (shlwapi.h)

  • Статья

Создает ссылку для каждого потока на объект COM.

Синтаксис

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

Параметры

[in] pcRef

Тип: LONG*

Указатель на значение , обычно локальная переменная в ThreadProc потока, которая используется интерфейсом в ppunk в качестве счетчика ссылок.

[out] ppunk

Тип: IUnknown**

Адрес указателя на интерфейс IUnknown . В случае успешного выполнения этот параметр сохраняет указатель IUnknown потока при возврате. Приложение отвечает за освобождение указателя после его завершения.

Возвращаемое значение

Тип: HRESULT

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Дополнительные сведения об использовании API потоков Shlwapi см. в статье Управление ссылками на потоки.

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shlwapi.h
Библиотека Shlwapi.lib
DLL Shlwapi.dll (версия 6.0 или более поздняя)

См. также раздел

SHCreateThread

SHGetThreadRef

SHReleaseThreadRef

SHSetThreadRef