產生介面 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 取代為介面的實際名稱。