Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
GUIDFromString
Collapse the table of content
Expand the table of content

GUIDFromString function

[GUIDFromString is available through Windows XP with Service Pack 2 (SP2) or Windows Vista. It might be altered or unavailable in subsequent versions. Applications should use CLSIDFromString or IIDFromString in place of this function.]

Converts a string to a GUID.

Syntax


BOOL GUIDFromString(
  _In_  LPCTSTR psz,
  _Out_ LPGUID  pguid
);

Parameters

psz [in]

Type: LPCTSTR

A pointer to the null-terminated string to convert. The string should be in the following form:

{00000000-0000-0000-0000-000000000000}

pguid [out]

Type: LPGUID

Pointer to a buffer to receive the GUID when this method returns.

Return value

Type: BOOL

TRUE if the GUID was created successfully; otherwise, FALSE.

Remarks

This function is not declared in a header or exported by name from a .dll file. It must be loaded from Shell32.dll as ordinal 703 for GUIDFromStringA and ordinal 704 for GUIDFromStringW.

It can also be accessed from Shlwapi.dll as ordinal 269 for GUIDFromStringA and ordinal 270 for GUIDFromStringW.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

DLL

Shell32.dll

Unicode and ANSI names

GUIDFromStringW (Unicode) and GUIDFromStringA (ANSI)

 

 

Community Additions

ADD
Show:
© 2015 Microsoft