SHResolveFolderPathInLibrary function (shobjidl.h)

Article
02/22/2024

Attempts to resolve the target location of a library folder that has been moved or renamed.

Syntax

HRESULT SHResolveFolderPathInLibrary(
  [in]  IShellLibrary *plib,
  [in]  PCWSTR        pszFolderPath,
  [in]  DWORD         dwTimeout,
  [out] PWSTR         *ppszResolvedPath
);

Parameters

[in] plib

Type: IShellLibrary*

The IShellLibrary object for which to resolve the target location.

[in] pszFolderPath

Type: PCWSTR

The path of the library folder to locate.

[in] dwTimeout

Type: DWORD

The maximum time, in milliseconds, that the method attempts to locate the folder before returning. If the folder could not be located before the specified time elapses, an error is returned.

[out] ppszResolvedPath

Type: PWSTR*

A pointer to a string that, when this function successfully returns, contains the current path of the library folder specified in plib.

Return value

Type: HRESULT

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

Remarks

This is an inline helper function that wraps the IShellLibrary::ResolveFolder method.

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.h