IShellWindows::Register-Methode (exdisp.h)

Registriert ein geöffnetes Fenster als Shellfenster; Das Fenster wird durch handle angegeben.

Syntax

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

Parameter

[in] pid

Typ: IDispatch*

Die IDispatch-Schnittstelle des Fensters.

[in] hwnd

Typ: long

Ein Handle, das das zu registrierende Fenster angibt.

[in] swClass

Typ: int

Ein Element von ShellWindowTypeConstants , das den Typ des Fensters angibt.

[out] plCookie

Typ: long*

Das Cookie des Fensters.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Im Kontext der Shellfenstersammlung ist ein Cookie ein Token, das ein registriertes Shellfenster eindeutig identifiziert.

Verwenden Sie diese Methode, um ein geöffnetes Fenster zu registrieren. Wenn das Fenster geöffnet ist, verwenden Sie stattdessen IShellWindows::RegisterPending .

Anforderungen

   
Zielplattform Windows
Kopfzeile exdisp.h
DLL Shdocvw.dll (Version 5.00.2014.0216 oder höher)

Weitere Informationen

IShellWindows

IShellWindows::RegisterPending

IShellWindows::Revoke