Метод IShellWindows::RegisterPending (exdisp.h)

Статья
08/23/2023

Регистрирует ожидающее окно как окно оболочки; окно задается абсолютным значением PIDL.

Синтаксис

HRESULT RegisterPending(
        long    lThreadId,
  [in]  VARIANT *pvarloc,
  [in]  VARIANT *pvarlocRoot,
  [in]  int     swClass,
  [out] long    *plCookie
);

Параметры

lThreadId

Идентификатор потока.

[in] pvarloc

Тип: VARIANT*

Variant типа VT_VARIANT | VT_BYREF. Задайте для параметра pvarloc абсолютное значение PIDL (PIDLIST_ABSOLUTE), указывающее регистрируемое окно.

[in] pvarlocRoot

Тип: VARIANT*

Должен иметь значение NULL или типа VT_EMPTY.

[in] swClass

Тип: int

Член ShellWindowTypeConstants , указывающий тип окна.

[out] plCookie

Тип: long*

Файл cookie окна.

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

Тип: HRESULT

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

Используйте этот метод для регистрации окна, которое находится в состоянии ожидания открытия; Если окно уже открыто, используйте вместо него IShellWindows::Register . Используйте IShellWindows::Revoke , чтобы отменить регистрацию окна.