Compartilhar via


Função UuidCreate (rpcdce.h)

A função UuidCreate cria uma nova UUID.

Sintaxe

RPC_STATUS UuidCreate(
  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, geralmente é desejável impedir que endereços ethernet em redes fiquem disponíveis fora de uma empresa ou organização. A função UuidCreate gera uma UUID que não pode ser rastreada até o endereço ethernet do computador no qual foi gerada. Ele também não pode ser associado a outros UUIDcriados no mesmo computador. Se você não precisar desse nível de segurança, seu aplicativo poderá usar a função UuidCreateSequential , que se comporta exatamente como a função UuidCreate faz em todas as outras versões do sistema operacional.

Requisitos

Requisito Valor
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

UuidFromString

UuidToString