UuidCreate-Funktion (rpcdce.h)

  • Artikel

Die UuidCreate-Funktion erstellt eine neue UUID.

Syntax

RPC_STATUS UuidCreate(
  UUID *Uuid
);

Parameter

Uuid

Gibt einen Zeiger auf die erstellte UUID zurück.

Rückgabewert

Wert Bedeutung
RPC_S_OK
 Der Aufruf war erfolgreich.
RPC_S_UUID_LOCAL_ONLY
 Die UUID ist garantiert nur für diesen Computer eindeutig.
RPC_S_UUID_NO_ADDRESS
 Die Ethernet- oder Tokenring-Hardwareadresse für diesen Computer kann nicht abgerufen werden.
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

Hinweise

Aus Sicherheitsgründen ist es häufig wünschenswert, ethernet-Adressen in Netzwerken nicht außerhalb eines Unternehmens oder organization verfügbar zu machen. Die UuidCreate-Funktion generiert eine UUID , die nicht auf die Ethernet-Adresse des Computers zurückverfolgt werden kann, auf dem sie generiert wurde. Es kann auch nicht mit anderen UUIDsverknüpft werden, die auf demselben Computer erstellt wurden. Wenn Sie diese Sicherheitsstufe nicht benötigen, kann Ihre Anwendung die UuidCreateSequential-Funktion verwenden, die sich genau wie die UuidCreate-Funktion in allen anderen Versionen des Betriebssystems verhält.

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

UuidFromString

UuidToString