Método IShellWindows::RegisterPending (exdisp.h)
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) |