Функция UuidCreateSequential (rpcdce.h)

  • Статья

Функция UuidCreateSequential создает новый UUID.

Синтаксис

RPC_STATUS UuidCreateSequential(
  UUID *Uuid
);

Параметры

Uuid

Возвращает указатель на созданный UUID.

Возвращаемое значение

Значение Значение
RPC_S_OK
 Вызов выполнен успешно.
RPC_S_UUID_LOCAL_ONLY
 UUID гарантированно будет уникальным только для этого компьютера.
RPC_S_UUID_NO_ADDRESS
 Не удается получить аппаратный адрес Ethernet или кольцевого маркера для этого компьютера.
 
Примечание Список допустимых кодов ошибок см. в разделе Возвращаемые значения RPC.
 

Комментарии

По соображениям безопасности UuidCreate было изменено таким образом, чтобы он больше не использовал MAC-адрес компьютера для создания UUID. Добавлена функция UuidCreateSequential, позволяющая создавать UUIDс использованием MAC-адреса ethernet-карта компьютера.

Функция UuidCreateSequential возвращает RPC_S_UUID_LOCAL_ONLY, если исходный компьютер не имеет круга Ethernet/токена (IEEE 802).x) адрес. В этом случае созданный UUID является допустимым идентификатором и гарантированно будет уникальным среди всех UUID, созданных на компьютере. Однако существует вероятность того, что другой компьютер без адреса кольцевой сети Ethernet или токена создал идентичный UUID. Поэтому никогда не следует использовать этот UUID для идентификации объекта, который не является строго локальным для вашего компьютера. Компьютеры с адресами Ethernet и круговых маркеров создают идентификаторы UUID, которые гарантированно будут глобально уникальными.

Примечание Функция UuidCreateSequential , как правило, немного быстрее, чем функция UuidCreate . Если важно учитывать производительность создания UUID , можно использовать функцию UuidCreateSequential .
 

Требования

   
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header rpcdce.h (включая Rpc.h)
Библиотека Rpcrt4.lib
DLL Rpcrt4.dll

См. также раздел

UuidCreate

UuidFromString

UuidToString