UuidCreateSequential 函数 (rpcdce.h)

  • 项目

UuidCreateSequential 函数创建新的 UUID。

语法

RPC_STATUS UuidCreateSequential(
  UUID *Uuid
);

parameters

Uuid

返回指向创建的 UUID 的指针。

返回值

值 含义
RPC_S_OK
 调用成功。
RPC_S_UUID_LOCAL_ONLY
 只能保证 UUID 对于此计算机是唯一的。
RPC_S_UUID_NO_ADDRESS
 无法获取此计算机的以太网或令牌环硬件地址。
 
注意 有关有效错误代码的列表，请参阅 RPC 返回值。
 

注解

出于安全原因， UuidCreate 已修改，以便它不再使用计算机的 MAC 地址来生成 UUID。 引入 UuidCreateSequential 以允许使用计算机的以太网卡的 MAC 地址创建 UUID。

当原始计算机没有以太网/令牌环 (IEEE 802 时， UuidCreateSequential 函数返回RPC_S_UUID_LOCAL_ONLY。x) 地址。 在这种情况下，生成的 UUID 是有效的标识符，并保证在计算机上生成的所有 UUID中是唯一的。 但是，有可能另一台没有以太网/令牌环地址的计算机生成了相同的 UUID。 因此，您绝不应使用此 UUID 来标识并非严格位于计算机本地的对象。 具有以太网/令牌环地址的计算机生成保证全局唯一的 UUID。

注意UuidCreateSequential 函数往往比 UuidCreate 函数略快。 当生成 UUID 的性能是一个重要考虑因素时，可以使用 UuidCreateSequential 函数。
 

要求

   
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 rpcdce.h (包括 Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll

请参阅

UuidCreate

UuidFromString

UuidToString