Fonction UuidCreate (rpcdce.h)

  • Article

La fonction UuidCreate crée un nouvel UUID.

Syntaxe

RPC_STATUS UuidCreate(
  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.
 

Remarques

Pour des raisons de sécurité, il est souvent souhaitable d’empêcher les adresses Ethernet sur les réseaux de devenir disponibles en dehors d’une entreprise ou d’un organization. La fonction UuidCreate génère un UUID qui ne peut pas être suivi à l’adresse Ethernet de l’ordinateur sur lequel il a été généré. Il ne peut pas non plus être associé à d’autres UUIDcréés sur le même ordinateur. Si vous n’avez pas besoin de ce niveau de sécurité, votre application peut utiliser la fonction UuidCreateSequential , qui se comporte exactement comme la fonction UuidCreate sur toutes les autres versions du système d’exploitation.

Configuration requise

Condition requise Valeur
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

UuidFromString

UuidToString