Freigeben über


UuidCreateSequential-Funktion (rpcdce.h)

Die UuidCreateSequential-Funktion erstellt eine neue UUID.

Syntax

RPC_STATUS UuidCreateSequential(
  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
Für diesen Computer kann keine Ethernet- oder Tokenringhardwareadresse abgerufen werden.
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

Hinweise

Aus Sicherheitsgründen wurde UuidCreate so geändert, dass die MAC-Adresse eines Computers nicht mehr zum Generieren von UUIDsverwendet wird. UuidCreateSequential wurde eingeführt, um die Erstellung von UUIDsmithilfe der MAC-Adresse des Ethernet-Karte eines Computers zu ermöglichen.

Die UuidCreateSequential-Funktion gibt RPC_S_UUID_LOCAL_ONLY zurück, wenn der ursprüngliche Computer keinen Ethernet/Token-Ring (IEEE 802) hat.x) Adresse. In diesem Fall ist die generierte UUID ein gültiger Bezeichner und garantiert unter allen auf dem Computer generierten UUIDseindeutig. Es besteht jedoch die Möglichkeit, dass ein anderer Computer ohne Ethernet-/Tokenringadresse die identische UUID generiert hat. Daher sollten Sie diese UUID niemals verwenden, um ein Objekt zu identifizieren, das nicht streng lokal für Ihren Computer ist. Computer mit Ethernet-/Tokenringadressen generieren UUIDs, die garantiert global eindeutig sind.

Hinweis Die UuidCreateSequential-Funktion ist in der Regel etwas schneller als die UuidCreate-Funktion . Wenn die Leistung der Generierung einer UUID ein wichtiger Aspekt ist, kann die UuidCreateSequential-Funktion verwendet werden.
 

Anforderungen

   
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 (include Rpc.h)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

UuidCreate

UuidFromString

UuidToString