IShellWindows::RegisterPending-Methode (exdisp.h)

Registriert ein ausstehendes Fenster als Shellfenster; Das Fenster wird durch eine absolute PIDL angegeben.

Syntax

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

Parameter

lThreadId

Eine Thread-ID.

[in] pvarloc

Typ: VARIANT*

Ein VARIANT vom Typ VT_VARIANT | VT_BYREF. Legen Sie den Wert von pvarloc auf eine absolute PIDL (PIDLIST_ABSOLUTE) fest, die das zu registrierende Fenster angibt.

[in] pvarlocRoot

Typ: VARIANT*

Muss NULL oder vom Typ VT_EMPTY sein.

[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 Fenster zu registrieren, das geöffnet ist. Wenn das Fenster bereits geöffnet ist, verwenden Sie stattdessen IShellWindows::Register . Verwenden Sie IShellWindows::Revoke , um die Registrierung eines Fensters aufzuheben.

Anforderungen

Weitere Informationen

IShellWindows

IShellWindows::Register

IShellWindows::Revoke