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

Registra uma janela aberta como uma janela do Shell; a janela é especificada pelo identificador.

Sintaxe

HRESULT Register(
  [in]  IDispatch *pid,
  [in]  long      hwnd,
  [in]  int       swClass,
  [out] long      *plCookie
);

Parâmetros

[in] pid

Tipo: IDispatch*

A interface IDispatch da janela.

[in] hwnd

Tipo: long

Um identificador que especifica a janela a ser registrada.

[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 aberta; se a janela estiver pendente aberta, use IShellWindows::RegisterPending .

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::RegisterPending

IShellWindows::Revoke