GUIDFromString-Funktion

[GUIDFromString ist über Windows XP mit Service Pack 2 (SP2) oder Windows Vista verfügbar. Er 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 auf NULL endende Zeichenfolge, die konvertiert werden soll. Die Zeichenfolge sollte folgendes Format haben:

{00000000-0000-0000-0000-000000000000}

pguid [ out]

Typ: LPGUID

Zeiger auf einen Puffer, der die GUID empfängt, wenn diese Methode zurückgegeben wird.

Rückgabewert

Typ: BOOL

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

Hinweise

Diese Funktion wird nicht in einem Header deklariert oder anhand des Namens aus einer .dll Datei exportiert. Sie muss aus Shell32.dll als Ordnungszahl 703 für GUIDFromStringA und Ordinalzahl 704 für GUIDFromStringW geladen werden.

Sie können auch über Shlwapi.dll als Ordnungszahl 269 für GUIDFromStringA und Ordinalzahl 270 für GUIDFromStringW darauf zugreifen.

Anforderungen

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