UuidToStringW-Funktion (rpcdce.h)

Artikel
11/20/2024

Die UuidToString-funktion konvertiert eine UUID- in eine Zeichenfolge.

Syntax

RPC_STATUS UuidToStringW(
  [in]  const UUID *Uuid,
  [out] RPC_WSTR   *StringUuid
);

Parameter

[in] Uuid

Zeiger auf eine binäre UUID-.

[out] StringUuid

Zeigen Sie auf die mit Null beendete Zeichenfolge, in die die im Uuid Parameter angegebene UUID- platziert wird.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_OUT_OF_MEMORY	Das System ist nicht genügend Arbeitsspeicher.

Hinweis Eine Liste gültiger Fehlercodes finden Sie unter RPC-Rückgabewerte.

Bemerkungen

Eine Anwendung ruft UuidToString- auf, um eine binäre UUID- in eine Zeichenfolge UUID-zu konvertieren. Die RPC-Laufzeitbibliothek weist Speicher für die im StringUuid Parameter zurückgegebene Zeichenfolge zu. Die Anwendung ist dafür verantwortlich, RpcStringFree- aufzurufen, um diesen Speicher zu verwalten.

Anmerkung

Der rpcdce.h-Header definiert UuidToString als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
mindestens unterstützte Server-	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform-	Fenster
Header-	rpcdce.h (include Rpc.h)
Library	Rpcrt4.lib
DLL-	Rpcrt4.dll

Siehe auch

RpcStringFree-

UuidFromString-

Freigeben über