DomainIdentifier 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
表示唯一網域識別碼。
public class DomainIdentifier
type DomainIdentifier = class
Public Class DomainIdentifier
- 繼承
-
DomainIdentifier
備註
網域識別碼有三個元件:
- 服務識別碼 - 網域所屬服務的唯一識別碼。
- 帳戶識別碼 - 服務內帳戶的唯一識別碼。
- 修訂 - 識別此識別碼所參考網域的版本。 修訂的值是建立時的時間戳記,並以通用協調時間的午夜 1970 年 1 月 1 日之後的秒數表示。 有效的修訂值介於 1 和0xFFFFFFFF (內含) 之間。
當用戶端提出加入網域的要求時,服務會使用此類別來建立用戶端的網域識別碼,並將它傳遞至 DomainCertificateBuilder 以建置有效的網域憑證。 服務也會將它與其他資訊一起傳遞至 物件, JoinDomainResponse 讓伺服器傳回用戶端的有效回應。 如需利用這個類別的網域加入實作範例,請參閱 DomainMembership.cs 範例。 在取得授權期間,這個類別也可以用來儲存從挑戰剖析的用戶端的相關網域識別碼資料。 服務的網域識別碼資料後續可以儲存在此類別的另一個實例中,然後用來驗證用戶端的網域識別碼是否與服務有效。
建構函式
DomainIdentifier() |
初始化 DomainIdentifier 類別的新執行個體。 |
DomainIdentifier(Guid) |
使用指定的服務識別碼, DomainIdentifier 初始化 類別的新實例。 系統會隨機產生帳戶識別碼,並將修訂設定為 CurrentRevision 。 |
DomainIdentifier(Guid, Guid) |
使用指定的服務識別碼和帳戶識別碼, DomainIdentifier 初始化 類別的新實例。 修訂設定為 CurrentRevision 。 |
DomainIdentifier(Guid, Guid, DateTime) |
使用以時間戳記表示的 DomainIdentifier 指定服務識別碼、帳戶識別碼和修訂,初始化 類別的新實例。 |
DomainIdentifier(Guid, Guid, Int64) |
使用以 long 表示的 DomainIdentifier 指定服務識別碼、帳戶識別碼和修訂,初始化 類別的新實例。 |
欄位
MaxRevision |
允許的修訂值上限。 等於 0xFFFFFFFF。 |
MinRevision |
允許的最小修訂值。 等於零。 |
屬性
AccountId |
取得或設定服務內帳戶的唯一識別碼。 |
CurrentRevision |
根據目前的日期和時間傳回 tevision。 傳回的修訂代表自通用國際標準時間 1970 年 1 月 1 日午夜起的秒數。 |
IsEmpty |
取得這個網域識別碼是否空白。 |
Revision |
取得或設定這個識別碼所參考之網域的版本。 |
ServiceId |
取得或設定網域所屬服務的唯一識別碼。 |
方法
GetRevision(DateTime) |
將指定的 DateTime 值轉換為修訂。 傳回的修訂代表自通用國際標準時間 1970 年 1 月 1 日午夜起的秒數。 |
GetTimestamp(Int64) |
將指定的修訂值轉換為 DateTime。 指定的修訂代表自通用國際標準時間 1970 年 1 月 1 日午夜以來的秒數。 |