Метод IShellWindows::RegisterPending (exdisp.h)
Регистрирует ожидающее окно как окно оболочки; окно задается абсолютным значением 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 .
Комментарии
В контексте коллекции окон оболочки файл cookie — это маркер, который однозначно идентифицирует зарегистрированное окно оболочки.
Используйте этот метод для регистрации окна, которое находится в состоянии ожидания открытия; Если окно уже открыто, используйте вместо него IShellWindows::Register . Используйте IShellWindows::Revoke , чтобы отменить регистрацию окна.
Требования
| Целевая платформа | Windows |
| Header | exdisp.h |
| DLL | Shdocvw.dll (версия 5.00.2014.0216 или более поздняя) |