Generování identifikátorů UUID rozhraní
Tato část obsahuje informace o univerzálních jedinečných identifikátorech (UUID) a nástroji Uuidgen v následujících tématech:
- Co je UUID?
- Používání Uuidgen
Co je UUID?
Všechna rozhraní musí být jedinečně identifikována v síti, aby je klienti mohli najít. V malých sítích může název samotného rozhraní stačit k jeho identifikaci. To ale obvykle není možné ve velkých sítích. Vývojáři proto každému rozhraní obvykle přiřazují univerzální jedinečný identifikátor (UUID, zaměnitelný s termínem GUID nebo globálně jedinečný identifikátor). UUID je řetězec, který obsahuje sadu šestnáctkových číslic. Každé rozhraní má jiné UUID. Podrobnosti viz Řetězcový UUID.
Textová reprezentace UUID je řetězec skládající se z 8 hexadecimálních číslic, po nichž následuje pomlčka, poté tři skupiny po 4 hexadecimálních číslicích oddělené pomlčkami, a nakonec 12 hexadecimálních číslic. Následující příklad je platný řetězec UUID:
ba209999-0c6c-11d2-97cf-00c04f8eea45
Prázdné identifikátory UUID se označují jako nil UUID, nikoliv identifikátory UUID s hodnotou NULL. Termín nil označuje cokoli, co je nula, prázdné, nevyplněné nebo neinicializované. Prázdný řetězec, prázdný záznam databáze nebo neinicializované UUID jsou všechny příklady hodnot nil.
Poznámka
Hodnota null je konkrétní hodnota nula. Často se používá v programování jazyka C a C++ ve spojení s ukazateli. Nil je obecnější pojem než NULL. Identifikátory UUID neinicializovaného rozhraní objektu by měly být vždy označovány jako identifikátory nil UUID místo identifikátory UUID s hodnotou NULL.
Použití Uuidgen
Microsoft poskytuje utility program s názvem Uuidgen k vygenerování identifikátorů UUID. Nástroj Uuidgen vygeneruje UUID ve formátu souboru IDL nebo ve formátu jazyka C.
Při spuštění nástroje Uuidgen z příkazového řádku můžete použít následující přepínače příkazů.
| Přepínač Uuidgen | Popis |
|---|---|
| /i | Vypíše UUID do šablony rozhraní IDL. |
| /s | Vypíše UUID jako inicializovanou strukturu jazyka C. |
| /o<název souboru> | Přesměruje výstup do souboru; zadaný ihned za přepínačem /o. |
| /n<číslo> | Určuje počet identifikátorů UUID, které se mají vygenerovat. |
| /v | Zobrazí informace o verzi programu Uuidgen. |
| /h nebo ? | Zobrazí souhrn možností příkazů. |
Obvykle použijete nástroj Uuidgen, jak je znázorněno v následujícím příkladu.
uuidgen -i -oMyApp.idl
Tento příkaz vygeneruje UUID a uloží ho do souboru MIDL, který můžete použít jako šablonu. Při spuštění předchozího příkazu se obsah Souboru MyApp.idl podobá následujícímu:
[
uuid(ba209999-0c6c-11d2-97cf-00c04f8eea45),
version(1.0)
]
interface INTERFACENAME
{
}
Dalším krokem bude nahrazení zástupného názvu rozhraní INTERFACENAME skutečným názvem vašeho rozhraní.