Compartir a través de

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

  • Artículo

Registra una ventana pendiente como una ventana shell; la ventana se especifica mediante un PIDL absoluto.

Sintaxis

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

Parámetros

lThreadId

Identificador de subproceso.

[in] pvarloc

Tipo: VARIANT*

Variant de tipo VT_VARIANT | VT_BYREF. Establezca el valor de pvarloc en un PIDL absoluto (PIDLIST_ABSOLUTE) que especifica la ventana que se va a registrar.

[in] pvarlocRoot

Tipo: VARIANT*

Debe ser NULL o de tipo VT_EMPTY.

[in] swClass

Tipo: int

Miembro de ShellWindowTypeConstants que especifica el tipo de ventana.

[out] plCookie

Tipo: long*

Cookie de la ventana.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

En el contexto de la colección de ventanas de Shell, una cookie es un token que identifica de forma única una ventana de Shell registrada.

Utilice este método para registrar una ventana que está pendiente de apertura; Si la ventana ya está abierta, use IShellWindows::Register en su lugar. Use IShellWindows::Revoke para anular el registro de una ventana.

Requisitos

   
Plataforma de destino Windows
Encabezado exdisp.h
Archivo DLL Shdocvw.dll (versión 5.00.2014.0216 o posterior)

Consulte también

IShellWindows

IShellWindows::Register

IShellWindows::Revoke