Share via

Fonction UuidCreateSequential (rpcdce.h)

  • Article

La fonction UuidCreateSequential crée un nouvel UUID.

Syntaxe

RPC_STATUS UuidCreateSequential(
  UUID *Uuid
);

Paramètres

Uuid

Retourne un pointeur vers l’UUID créé.

Valeur retournée

Valeur Signification
RPC_S_OK
 L’appel a réussi.
RPC_S_UUID_LOCAL_ONLY
 L’UUID est garanti comme étant unique à cet ordinateur uniquement.
RPC_S_UUID_NO_ADDRESS
 Impossible d’obtenir l’adresse matérielle Ethernet ou en anneau de jeton pour cet ordinateur.
 
Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.
 

Notes

Pour des raisons de sécurité, UuidCreate a été modifié pour qu’il n’utilise plus l’adresse MAC d’un ordinateur pour générer des UUID. UuidCreateSequential a été introduit pour permettre la création d’UUIDà l’aide de l’adresse MAC du carte Ethernet d’une machine.

La fonction UuidCreateSequential retourne RPC_S_UUID_LOCAL_ONLY lorsque l’ordinateur d’origine n’a pas d’anneau ethernet/jeton (IEEE 802.x) adresse. Dans ce cas, l’UUID généré est un identificateur valide et est garanti comme unique parmi tous les UUIDgénérés sur l’ordinateur. Toutefois, il est possible qu’un autre ordinateur sans adresse d’anneau Ethernet/jeton génère l’UUID identique. Par conséquent, vous ne devez jamais utiliser cet UUID pour identifier un objet qui n’est pas strictement local sur votre ordinateur. Les ordinateurs avec des adresses ethernet/en anneau de jeton génèrent des UUIDqui sont garantis pour être globalement uniques.

Note La fonction UuidCreateSequential a tendance à être légèrement plus rapide que la fonction UuidCreate . Lorsque les performances de la génération d’un UUID sont importantes, la fonction UuidCreateSequential peut être utilisée.
 

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête rpcdce.h (inclure Rpc.h)
Bibliothèque Rpcrt4.lib
DLL Rpcrt4.dll

Voir aussi

UuidCreate

UuidFromString

UuidToString