CoCreateGuid, fonction (combaseapi.h)

  • Article

Crée un GUID, un entier 128 bits unique utilisé pour les CLSID et les identificateurs d’interface.

Syntaxe

HRESULT CoCreateGuid(
  [out] GUID *pguid
);

Paramètres

[out] pguid

Pointeur vers le GUID demandé.

Valeur retournée

Code de retour Description
S_OK
 Le GUID a été créé avec succès.
 

Les erreurs retournées par UuidCreate sont encapsulées en tant que HRESULT.

Remarques

La fonction CoCreateGuid appelle la fonction RPC UuidCreate, qui crée un GUID, un entier global unique 128 bits. Utilisez CoCreateGuid lorsque vous avez besoin d’un nombre absolument unique que vous utiliserez comme identificateur persistant dans un environnement distribué. Avec un degré de certitude très élevé, cette fonction retourne une valeur unique : aucune autre invocation, sur le même système ou tout autre système (réseau ou non), ne doit retourner la même valeur.

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 combaseapi.h (inclure Objbase.h)
Bibliothèque Ole32.lib
DLL Ole32.dll

Voir aussi

UuidCreate