SHLoadInProc function (shlobj_core.h)

2024-02-22

Creates an instance of the specified object class from within the context of the Shell's process.

Windows Vista and later: This function has been disabled and returns E_NOTIMPL.

Syntax

SHSTDAPI SHLoadInProc(
  [in] REFCLSID rclsid
);

Parameters

[in] rclsid

Type: REFCLSID

The CLSID of the object class to be created.

Return value

Type: HRESULT

Returns S_OK if successful, or an error value otherwise. In Windows Vista and later versions, always returns E_NOTIMPL.

Remarks

Note This function is available through Windows XP Service Pack 2 (SP2) and Windows Server 2003. It is not available in later versions of Windows, including Windows Vista.

This function creates the requested object instance by calling the CoCreateInstance function and immediately releasing the returned object. The associated DLL is unloaded according to standard Component Object Model (COM) rules when it returns S_OK from its DllCanUnloadNow function.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	shlobj_core.h (include Shlobj.h)
Library	Shell32.lib
DLL	Shell32.dll (version 4.0 or later)