Udostępnij przez

Generowanie identyfikatorów UUID interfejsu

W tej sekcji przedstawiono informacje dotyczące identyfikatorów uniwersalnych (UUID) i narzędzia Uuidgen w następujących tematach:

Co to jest identyfikator UUID?

Wszystkie interfejsy muszą być jednoznacznie identyfikowane w sieci, aby klienci mogli je znaleźć. W małych sieciach sama nazwa interfejsu może być wystarczająca, aby go zidentyfikować. Jednak zwykle nie jest to możliwe w przypadku dużych sieci. W związku z tym deweloperzy zazwyczaj przypisują do każdego interfejsu uniwersalny unikatowy identyfikator (UUID, zamienny z terminem GUID lub globalnie unikatowy identyfikator). UUID to ciąg zawierający zestaw cyfr szesnastkowych. Każdy interfejs ma inny identyfikator UUID. Aby uzyskać szczegółowe informacje, zobacz identyfikator ciągu UUID .

Tekstowa reprezentacja identyfikatora UUID jest ciągiem składającym się z 8 cyfr szesnastkowych, po których następuje łącznik, po którym następuje trzy rozdzielone łącznikami grupy 4 cyfr szesnastkowych, a następnie łącznik, po którym następuje 12 cyfr szesnastkowych. Poniższy przykład jest prawidłowym ciągiem UUID:

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

Puste identyfikatory UUID są określane jako identyfikatory UUID zerowe, a nie identyfikatory UUID o wartości null. Termin nil wskazuje na wszystko, co jest zerowe, puste, niewypełnione lub niezainicjowane. Pusty ciąg, pusty rekord bazy danych lub niezainicjowany identyfikator UUID to wszystkie przykłady wartości zerowych.

Notatka

Wartość null jest określoną wartością zero. Jest on często używany w programowaniu C i C++ w połączeniu ze wskaźnikami. Nil jest bardziej ogólnym terminem niż null. Identyfikatory UUID interfejsu niezainicjowanego obiektu powinny być zawsze określane jako identyfikatory UUID zerowe, a nie identyfikatory UUID o wartości null null.

 

Korzystanie z interfejsu Uuidgen

Firma Microsoft udostępnia program narzędziowy o nazwie Uuidgen do generowania identyfikatorów UUID. Narzędzie Uuidgen generuje identyfikator UUID w formacie pliku IDL lub w formacie języka C.

Po uruchomieniu narzędzia Uuidgen z wiersza polecenia można użyć następujących przełączników poleceń.

Przełącznik Uuidgen Opis
/i Zwraca identyfikator UUID do szablonu interfejsu IDL.
/s Generuje identyfikator UUID jako zainicjowaną strukturę języka C.
/o<nazwa pliku> Przekierowuje dane wyjściowe do pliku; który jest określony bezpośrednio po przełączniku /o.
/n<number> Określa liczbę identyfikatorów UUID do wygenerowania.
/v Wyświetla informacje o wersji programu Uuidgen.
/h lub ? Wyświetla podsumowanie opcji polecenia.

 

Zazwyczaj użyjesz narzędzia Uuidgen, jak pokazano w poniższym przykładzie.

uuidgen -i -oMyApp.idl

To polecenie generuje identyfikator UUID i przechowuje go w pliku MIDL, którego można użyć jako szablonu. Po wykonaniu powyższego polecenia zawartość pliku MyApp.idl jest podobna do następującej:

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

}

Następnym krokiem będzie zastąpienie nazwy symbolu zastępczego INTERFACENAME rzeczywistą nazwą interfejsu.

 

 

  • Last updated on