SHResolveLibrary function (shobjidl_core.h)

Article
02/22/2024

Resolves all locations in a library, even those locations that have been moved or renamed.

Syntax

HRESULT SHResolveLibrary(
  [in] IShellItem *psiLibrary
);

Parameters

[in] psiLibrary

Type: IShellItem*

A pointer to an IShellItem object that represents the library.

Return value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This function can block the calling thread for as long as it takes to resolve all the locations in the specified library. Because it blocks the thread from which it is called, it should not be called from a thread that also handles user interface interactions.

This function resolves all locations in the specified library in a single call. To resolve an individual location in a library, see the IShellLibrary::ResolveFolder method or the SHResolveFolderPathInLibrary function.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll