Gerando UUIDs de interface

  • Artigo

Esta seção apresenta informações sobre UUIDs (Identificadores Exclusivos Universais) e o utilitário Uuidgen nos seguintes tópicos:

O que é uma 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 redes grandes. Portanto, os desenvolvedores normalmente atribuem um UUID (Identificador Exclusivo Universal, intercambiável com o termo GUID ou Identificador Global exclusivo) a cada interface. Uma UUID é uma cadeia de caracteres que contém um conjunto de dígitos hexadecimal. Cada interface tem uma UUID diferente. Para obter detalhes, consulte UUID de cadeia de caracteres.

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

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

UUIDs vazios são chamados de UUIDs nulos 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 uma UUID não inicializada são todos exemplos de valores nulos.

Observação

O valor NULL é o valor específico zero. Geralmente, ele é usado na 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 ser sempre chamados de UUIDs nulos em vez de UUIDs NULL .

 

Usando Uuidgen

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

Ao executar o utilitário Uuidgen na linha de comando, você pode usar as opções de comando a seguir.

Opção Uuidgen Descrição
/i Gera UUID para um modelo de interface IDL.
/s Gera UUID como uma estrutura C inicializada.
/o<Filename> Redireciona a saída para um arquivo; especificado imediatamente após a opção /o .
/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, conforme mostrado no exemplo a seguir.

uuidgen -i -oMyApp.idl

Esse comando gera uma UUID e a armazena em um arquivo MIDL que você pode usar como modelo. Quando o comando anterior é executado, o conteúdo do 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 interface.