Método IShellWindows::RegisterPending (exdisp.h)

  • Artigo

Registra uma janela pendente como uma janela do Shell; a janela é especificada por um PIDL absoluto.

Sintaxe

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

Parâmetros

lThreadId

Uma ID de thread.

[in] pvarloc

Tipo: VARIANT*

Uma VARIANT do tipo VT_VARIANT | VT_BYREF. Defina o valor de pvarloc como um PIDL absoluto (PIDLIST_ABSOLUTE) que especifica a janela a ser registrada.

[in] pvarlocRoot

Tipo: VARIANT*

Deve ser NULL ou do tipo VT_EMPTY.

[in] swClass

Tipo: int

Um membro de ShellWindowTypeConstants que especifica o tipo de janela.

[out] plCookie

Tipo: long*

O cookie da janela.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

No contexto da coleção de janelas do Shell, um cookie é um token que identifica exclusivamente uma janela do Shell registrada.

Use esse método para registrar uma janela pendente aberta; se a janela já estiver aberta, use IShellWindows::Register . Use IShellWindows::Revoke para cancelar o registro de uma janela.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho exdisp.h
DLL Shdocvw.dll (versão 5.00.2014.0216 ou posterior)

Confira também

IShellWindows

IShellWindows::Register

IShellWindows::Revoke