IIDFromString function (combaseapi.h)

Converts a string generated by the StringFromIID function back into the original interface identifier (IID).

Syntax

HRESULT IIDFromString(
  [in]  LPCOLESTR lpsz,
  [out] LPIID     lpiid
);

Parameters

[in] lpsz

A pointer to the string representation of the IID or NULL.

[out] lpiid

A pointer to the requested IID on return.

Return value

This function can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, and S_OK.

Remarks

The function converts the interface identifier in a way that guarantees different interface identifiers will always be converted to different strings.

The IID format is {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}.

Passing NULL results in GUID_NULL value.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header combaseapi.h (include Objbase.h)
Library Ole32.lib
DLL Ole32.dll

See also

StringFromIID