Función SetProcessReference (shlwapi.h)
Proporciona un objeto Component Object Model (COM) 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 SetProcessReference(
[in, optional] IUnknown *punk
);
Parámetros
[in, optional] punk
Puntero al objeto para el que desea almacenar una referencia. Este valor puede ser NULL.
Valor devuelto
None
Observaciones
Windows Explorer e Internet Explorer pueden usar SetProcessReference para permitir que componentes como extensiones de Shell amplíen la duración del proceso. Otras aplicaciones también pueden usar SetProcessReference para permitir la misma funcionalidad. Por ejemplo, el bucle de mensajes del explorador y el escritorio proxy usan SetProcessReference para permitir que otros subprocesos extiendan 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 SetProcessReference para detectar si se hospedan desde Windows Explorer o Internet Explorer.
El puntero de interfaz pasado a SetProcessReference debe hacer referencia a un objeto de subproceso libre.
Cada vez que un componente llama a GetProcessReference, 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 SetProcessReference 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 GetProcessReference.
Requisitos
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shlwapi.h |
| Library | Shlwapi.lib |
| Archivo DLL | Api-ms-win-shcore-thread-L1-1-0.dll |