IKnownFolderManager::FolderIdFromCsidl method (shobjidl_core.h)

Gets the KNOWNFOLDERID that is the equivalent of a legacy CSIDL value.

Syntax

HRESULT FolderIdFromCsidl(
  [in]  int           nCsidl,
  [out] KNOWNFOLDERID *pfid
);

Parameters

[in] nCsidl

Type: int

The CSIDL value.

[out] pfid

Type: KNOWNFOLDERID*

When this method returns, contains a pointer to the KNOWNFOLDERID. This pointer is passed uninitialized.

Return value

Type: HRESULT

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

Remarks

To call this method, the caller must have at least User privileges.

Requirements

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

See also

IKnownFolderManager

IKnownFolderManager::FolderIdToCsidl

Known Folders Sample