StringFromCLSID-Funktion (combaseapi.h)

  • Artikel

Konvertiert eine CLSID in eine Zeichenfolge mit druckbaren Zeichen. Unterschiedliche CLSIDs konvertieren immer in unterschiedliche Zeichenfolgen.

Syntax

HRESULT StringFromCLSID(
  [in]  REFCLSID rclsid,
  [out] LPOLESTR *lplpsz
);

Parameter

[in] rclsid

Die zu konvertierende CLSID.

[out] lplpsz

Die Adresse einer Zeigervariable, die einen Zeiger auf die resultierende Zeichenfolge empfängt. Die Zeichenfolge, die rclsid darstellt, enthält eingeschlossene Klammern.

Rückgabewert

Diese Funktion kann die Standardrückgabewerte E_OUTOFMEMORY und S_OK zurückgeben.

Hinweise

StringFromCLSID ruft die StringFromGUID2-Funktion auf, um einen Globally Unique Identifier (GUID) in eine Zeichenfolge mit druckbaren Zeichen zu konvertieren.

Der Aufrufer ist für das Freigeben des für die Zeichenfolge zugewiesenen Arbeitsspeichers verantwortlich, indem er die CoTaskMemFree-Funktion aufruft.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile combaseapi.h (include Objbase.h)
Bibliothek Ole32.lib
DLL Ole32.dll

Weitere Informationen

CLSIDFromString

StringFromGUID2