提供一个接口,允许托管 Shell 扩展和其他组件阻止其主机进程过早关闭。 主机进程通常是 Windows 资源管理器或 Windows Internet Explorer,但其他应用程序也可以使用此函数。
void SHSetInstanceExplorer(
[in, optional] IUnknown *punk
[in, optional] punk
类型: IUnknown*
指向自由线程 IUnknown 的指针。 组件可以通过 SHGetInstanceExplorer) 使用此接口 (,以防止主机进程终止。 此值可以为 NULL,在这种情况下,进程引用不再可供组件使用。
Windows Explorer 和 Internet Explorer 可以使用 SHSetInstanceExplorer 允许 Shell 扩展等组件延长进程的生存期。 其他应用程序还可以使用 SHSetInstanceExplorer 来允许相同的功能。 例如,浏览器消息循环和代理桌面使用 SHSetInstanceExplorer 让其他线程延长其生存期。
调用此函数的 Windows Explorer 和 Internet Explorer 以外的应用程序可能会遇到兼容性问题,因为某些组件使用 SHGetInstanceExplorer 检测它们是否托管在 Windows Explorer 或 Internet Explorer 中。
传递给 SHSetInstanceExplorer 的接口指针必须引用自由线程对象。
每当组件调用 SHGetInstanceExplorer 时,系统都会调用 AddRef 方法,然后再将接口指针返回到调用组件。 然后,组件在处理完成后调用 IUnknown::Release 方法。 调用 SHSetInstanceExplorer 的进程不得终止,而提供的接口指针的引用计数为非零。
有关组件如何使用进程引用的详细信息,请参阅 SHGetInstanceExplorer。