UuidToStringW-Funktion (rpcdce.h)

  • Artikel

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

Zeiger auf die NULL-endende Zeichenfolge, in die die im Uuid-Parameter angegebene UUID eingefügt wird.

Rückgabewert

Wert Bedeutung
RPC_S_OK
 Der Aufruf war erfolgreich.
RPC_S_OUT_OF_MEMORY
 Das System hat nicht genügend Arbeitsspeicher.
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

Hinweise

Eine Anwendung ruft UuidToString auf, um eine binäre UUID in eine UUID-Zeichenfolge zu konvertieren. Die RPC-Laufzeitbibliothek ordnet Arbeitsspeicher für die im StringUuid-Parameter zurückgegebene Zeichenfolge zu. Die Anwendung ist dafür verantwortlich , RpcStringFree aufzurufen, um die Zuordnung dieses Arbeitsspeichers aufzugeben.

Hinweis

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
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 rpcdce.h (rpc.h einschließen)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

RpcStringFree

UuidFromString