產生介面 UUID
本節提供下列主題中的通用唯一識別碼 (UUIDs) 和 Uuidgen 公用程式的相關資訊:
什麼是 UUID?
所有介面都必須在網路上唯一識別,用戶端才能找到它們。 在小型網路上,介面的名稱可能就足以識別它。 不過,這在大型網路上通常不可行。 因此,開發人員通常會將通用唯一識別碼 (UUID、與 GUID 一詞交換,或全域唯一識別碼) 指派給每個介面。 UUID 是包含一組十六進位數位的字串。 每個介面都有不同的 UUID。 如需詳細資訊,請參閱 字串 UUID。
UUID 的文字表示是由 8 個十六進位數位後面接著連字號所組成的字串,後面接著三個以十六進位數位分隔的連字號群組,後面接著連字號,後面接著 12 個十六進位數位。 下列範例是有效的 UUID 字串:
ba209999-0c6c-11d2-97cf-00c04f8eea45
空的 UUID 稱為 nil UUID,而不是 Null UUID。 nil 一詞表示任何為零、空白、空白或未初始化的專案。 空字串、空的資料庫記錄或未初始化的 UUID 都是 nil 值的範例。
注意
Null值是特定值零。 它通常用於 C 和 C++ 程式設計搭配指標。 Nil 比 Null更一般。 未初始化的物件介面 UUID 一律稱為 nil UUID,而不是 Null UUID。
使用 Uuidgen
Microsoft 提供名為 Uuidgen 的公用程式來產生您的 UUID。 Uuidgen 公用程式會產生 IDL 檔案格式或 C 語言格式的 UUID。
當您從命令列執行 Uuidgen 公用程式時,您可以使用下列命令參數。
Uuidgen 參數 | 描述 |
---|---|
/我 | 將 UUID 輸出至 IDL 介面範本。 |
/s | 輸出 UUID 做為初始化的 C 結構。 |
/o<檔案名> | 將輸出重新導向至檔案;在 /o 參數之後立即指定。 |
/n<數量> | 指定要產生的 UUID 數目。 |
/v | 顯示 Uuidgen 的版本資訊。 |
/h 或 ? | 顯示命令選項摘要。 |
一般而言,您將使用 Uuidgen 公用程式,如下列範例所示。
uuidgen -i -oMyApp.idl
此命令會產生 UUID,並將它儲存在您可以作為範本的 MIDL 檔案中。 執行上述命令時,MyApp.idl 的內容類別似下列內容:
[
uuid(ba209999-0c6c-11d2-97cf-00c04f8eea45),
version(1.0)
]
interface INTERFACENAME
{
}
下一個步驟是將預留位置名稱 INTERFACENAME 取代為介面的實際名稱。