Ler em inglês

Compartilhar via


atributo uuid

O atributo de interface [uuid] designa um UUID (identificador universal exclusivo) atribuído à interface e que o distingue de outras interfaces.

uuid (string-uuid) 
uuid ("string-uuid")

Parâmetros

string-uuid

Especifica uma cadeia de caracteres que consiste em 8 dígitos hexadecimal seguidos por um hífen e, em seguida, três grupos de 4 dígitos hexadecimal cada um seguido por um hífen e, em seguida, 12 dígitos hexadecimal. Você pode colocar a cadeia de caracteres UUID entre aspas, exceto quando usar a opção /osf do compilador MIDL.

Comentários

A biblioteca em tempo de execução usa a interface UUID que o atributo [uuid] designa para ajudar a estabelecer a comunicação entre os aplicativos cliente e servidor. O atributo [uuid] pode aparecer na lista de atributos de interface para uma interface RPC ou uma interface COM.

Para uma interface RPC, a lista de atributos de interface deve incluir o atributo [uuid] ou o atributo [local] , e a que você escolher deve ocorrer exatamente uma vez. Se a lista incluir o atributo [uuid] , ela também poderá incluir o atributo [versão] .

Para uma interface COM (identificada pelo atributo de interface [objeto] ), a lista de atributos de interface deve incluir o atributo [uuid] , mas não pode incluir o atributo [versão] . A lista de uma interface COM pode incluir o atributo [local] , mesmo que o atributo [uuid] esteja presente.

O Microsoft RPC dá suporte a uma extensão para IDL de DCE que permite que a UUID seja colocada entre aspas duplas ("" ""). O formulário entre aspas é necessário para pré-processadores do compilador C que interpretam números UUID como números de ponto flutuante.

Todos os valores UUID devem ser gerados pelo computador para garantir a exclusividade. Use o utilitário Uuidgen para gerar valores UUID exclusivos.

A UUID e os números de versão da interface são usados para determinar se o cliente pode se associar ao servidor. Para que o cliente se associe ao servidor, a UUID especificada nas interfaces do cliente e do servidor deve ser a mesma.

Observe que uma interface sem atributos pode ser importada para um arquivo IDL base. No entanto, a interface deve conter apenas tipos de dados sem procedimentos. Se até mesmo um procedimento estiver contido na interface, um atributo local ou UUID deverá ser especificado.

Exemplos

uuid(6B29FC40-CA47-1067-B31D-00DD010662DA) 
 
uuid("6B29FC40-CA47-1067-B31D-00DD010662DA")

Confira também

Arquivo IDL (Definição de Interface)

Interface

Local

Objeto

/Osf

version