Edit

Share via

SHCLSIDFromString function (shlobj_core.h)

  • Article

[This function is available through Windows XP Service Pack 2 (SP2) and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows. Use CLSIDFromString instead.]

Takes the string form of a class identifier (CLSID) and creates the corresponding CLSID.

Syntax

SHSTDAPI SHCLSIDFromString(
  [in]  PCWSTR psz,
  [out] CLSID  *pclsid
);

Parameters

[in] psz

Type: PCWSTR

A Unicode string that contains the CLSID in the format, {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}.

[out] pclsid

Type: CLSID*

A pointer to a CLSID value that, when this function returns successfully, receives the converted string as a CLSID.

Return value

Type: HRESULT

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

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [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 5.0 or later)