Partilhar via

Geração de UUIDs de Interface

Esta seção apresenta informações sobre identificadores únicos universais (UUIDs) e o utilitário Uuidgen nos seguintes tópicos:

O que é um UUID?

Todas as interfaces devem ser identificadas exclusivamente em uma rede para que os clientes possam encontrá-las. Em redes pequenas, apenas o nome da interface pode ser suficiente para identificá-la. No entanto, isso geralmente não é viável em grandes redes. Portanto, os desenvolvedores normalmente atribuem um Identificador Único Universal (UUID, intercambiável com o termo GUID ou Identificador Exclusivo Global) a cada interface. Um UUID é uma cadeia de caracteres que contém um conjunto de dígitos hexadecimais. Cada interface tem um UUID diferente. Para obter detalhes, consulte String UUID.

A representação textual de um UUID é uma cadeia que consiste em 8 dígitos hexadecimais seguidos por um hífen, seguido por três grupos separados por hífen de 4 dígitos hexadecimais, seguido por um hífen, seguido por 12 dígitos hexadecimais. O exemplo a seguir é uma cadeia de caracteres UUID válida:

ba209999-0c6c-11d2-97cf-00c04f8eea45

UUIDs vazios são chamados de UUIDs nil em vez de UUIDs NULL. O termo nil indica qualquer coisa que seja zero, em branco, vazia ou não inicializada. Uma cadeia de caracteres vazia, um registro de banco de dados vazio ou um UUID não inicializado são exemplos de valores nulos.

Observação

O valor NULL é o valor específico zero. É frequentemente usado em programação C e C++ em conjunto com ponteiros. Nil é um termo mais geral do que NULL. UUIDs de interface de objeto não inicializados devem sempre ser referidos como UUIDs nulos em vez de UUIDs NULL.

 

Utilização do Uuidgen

A Microsoft fornece um programa utilitário chamado Uuidgen para gerar seus UUIDs. O utilitário Uuidgen gera o UUID no formato de arquivo IDL ou formato em linguagem C.

Quando você executa o utilitário Uuidgen a partir da linha de comando, você pode usar as seguintes opções de comando.

Opção Uuidgen Descrição
/i Emite UUID para um modelo de interface IDL.
/s Gera UUID como uma estrutura C inicializada.
/o<nome do arquivo> Redireciona a saída para um arquivo; Especificado imediatamente após o /o switch.
/n<número> Especifica o número de UUIDs a serem gerados.
/v Exibe informações de versão sobre Uuidgen.
/h ou ? Exibe o resumo da opção de comando.

 

Normalmente, você usará o utilitário Uuidgen como mostrado no exemplo a seguir.

uuidgen -i -oMyApp.idl

Este comando gera um UUID e o armazena em um arquivo MIDL que você pode usar como modelo. Quando o comando anterior é executado, o conteúdo de MyApp.idl é semelhante ao seguinte:

[
  uuid(ba209999-0c6c-11d2-97cf-00c04f8eea45),
  version(1.0)
]
interface INTERFACENAME
{

}

A próxima etapa seria substituir o nome do espaço reservado, INTERFACENAME, pelo nome real da sua interface.

 

 

  • Last updated on