Função UuidCreateSequential (rpcdce.h)

  • Artigo

A função UuidCreateSequential cria uma nova UUID.

Sintaxe

RPC_STATUS UuidCreateSequential(
  UUID *Uuid
);

Parâmetros

Uuid

Retorna um ponteiro para o UUID criado.

Valor retornado

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_UUID_LOCAL_ONLY
 A UUID tem a garantia de ser exclusiva somente para este computador.
RPC_S_UUID_NO_ADDRESS
 Não é possível obter o endereço de hardware Ethernet ou de anel de token para este computador.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

Por motivos de segurança, uuidCreate foi modificado para que ele não use mais o endereço MAC de um computador para gerar UUIDs. UuidCreateSequential foi introduzido para permitir a criação de UUIDsusando o endereço MAC do cartão Ethernet de um computador.

A função UuidCreateSequential retorna RPC_S_UUID_LOCAL_ONLY quando o computador de origem não tem um anel ethernet/token (IEEE 802.x) endereço. Nesse caso, o UUID gerado é um identificador válido e tem a garantia de ser exclusivo entre todos os UUIDgerados no computador. No entanto, existe a possibilidade de que outro computador sem um endereço de anel ethernet/token tenha gerado a UUID idêntica. Portanto, você nunca deve usar essa UUID para identificar um objeto que não seja estritamente local para seu computador. Computadores com endereços de anel ethernet/token geram UUIDque têm a garantia de serem globalmente exclusivos.

Nota A função UuidCreateSequential tende a ser um pouco mais rápida do que a função UuidCreate . Quando o desempenho da geração de um UUID é uma consideração significativa, a função UuidCreateSequential pode ser usada.
 

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho rpcdce.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

UuidCreate

UuidFromString

UuidToString