GUIDFromString-Funktion

[GUIDFromString ist über Windows XP mit Service Pack 2 (SP2) oder Windows Vista verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Anwendungen sollten anstelle dieser Funktion CLSIDFromString oder IIDFromString verwenden.]

Konvertiert eine Zeichenfolge in eine GUID.

Syntax

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

Parameter

psz [in]

Typ: LPCTSTR

Ein Zeiger auf die zu konvertierende NULL-Zeichenfolge. Die Zeichenfolge sollte in der folgenden Form vorliegen:

{00000000-0000-0000-0000-000000000000}

pguid [out]

Typ: LPGUID

Zeiger auf einen Puffer, um die GUID zu empfangen, wenn diese Methode zurückgibt.

Rückgabewert

Typ: BOOL

TRUE , wenn die GUID erfolgreich erstellt wurde; andernfalls FALSE.

Bemerkungen

Diese Funktion wird nicht in einem Header deklariert oder nach Name aus einer .dll Datei exportiert. Es muss aus Shell32.dll als Ordnungszahl 703 für GUIDFromStringA und ordinal 704 für GUIDFromStringW geladen werden.

Der Zugriff kann auch von Shlwapi.dll als Ordnungszahl 269 für GUIDFromStringA und ordinal 270 für GUIDFromStringW erfolgen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
DLL	Shell32.dll
Unicode- und ANSI-Name	GUIDFromStringW (Unicode) und GUIDFromStringA (ANSI)