Función SHSetInstanceExplorer (shlobj_core.h)

Proporciona una interfaz que permite que las extensiones de Shell hospedadas y otros componentes impidan que su proceso de host se cierre prematuramente. Normalmente, el proceso de host es Windows Explorer o Windows Internet Explorer, pero otras aplicaciones también pueden usar esta función.

Sintaxis

void SHSetInstanceExplorer(
  [in, optional] IUnknown *punk
);

Parámetros

[in, optional] punk

Tipo: IUnknown*

Puntero a un IUnknown de subproceso libre. Los componentes pueden usar esta interfaz (a través de SHGetInstanceExplorer) para evitar que el proceso de host termine. Este valor puede ser NULL, en cuyo caso la referencia de proceso ya no está disponible para los componentes.

Valor devuelto

None

Observaciones

Windows Explorer e Internet Explorer pueden usar SHSetInstanceExplorer para permitir que componentes como extensiones de Shell amplíen la duración del proceso. Otras aplicaciones también pueden usar SHSetInstanceExplorer para permitir la misma funcionalidad. Por ejemplo, el bucle de mensajes del explorador y el escritorio proxy usan SHSetInstanceExplorer para permitir que otros subprocesos amplíen su duración.

Las aplicaciones que no son Windows Explorer e Internet Explorer que llaman a esta función pueden encontrar problemas de compatibilidad porque algunos componentes usan SHGetInstanceExplorer para detectar si se hospedan desde Windows Explorer o Internet Explorer.

El puntero de interfaz pasado a SHSetInstanceExplorer debe hacer referencia a un objeto de subproceso libre.

Cada vez que un componente llama a SHGetInstanceExplorer, el sistema llama al método AddRef antes de devolver el puntero de interfaz al componente que realiza la llamada. A continuación, el componente llama al método IUnknown::Release cuando se completa el procesamiento. El proceso que llama a SHSetInstanceExplorer no debe finalizar mientras que el recuento de referencias del puntero de interfaz proporcionado es distinto de cero.

Para obtener más información sobre cómo usan los componentes las referencias de proceso, consulte SHGetInstanceExplorer.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h (incluya Shlobj.h)
Library	Shell32.lib
Archivo DLL	Shell32.dll (versión 5.0 o posterior)
Conjunto de API	ext-ms-win-shell-shell32-l1-2-1 (introducido en Windows 10, versión 10.0.10240)

Consulte también

SHGetInstanceExplorer