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
| Zielplattform | Windows |
| Kopfzeile | exdisp.h |
| DLL | Shdocvw.dll (Version 5.00.2014.0216 oder höher) |