IAzApplication：：InitializeClientContextFromName 方法 (azroles.h)
InitializeClientContextFromName 方法會從用戶端身分識別取得 IAzClientContext 物件指標，作為 (功能變數名稱、用戶端名稱) 組。
注意 可能的話，請呼叫 InitializeClientContextFromToken 函式，而不是 InitializeClientContextFromName。 如需詳細資訊，請參閱＜備註＞。
語法
HRESULT InitializeClientContextFromName(
[in] BSTR ClientName,
[in, optional] BSTR DomainName,
[in, optional] VARIANT varReserved,
[out] IAzClientContext **ppClientContext
);
參數
[in] ClientName
安全性主體的名稱。
[in, optional] DomainName
用戶帳戶所在的功能變數名稱。 預設值是 NULL。
[in, optional] varReserved
保留供未來使用。 此參數可以是下列其中一個值：
- varReserved.vt == VT_ERROR 和 varReserved.scode == DISP_E_PARAMNOTFOUND
- varReserved.vt == VT_EMPTY
- varReserved.vt == VT_NULL
- varReserved.vt == VT_I4 和 varReserved.lVal == 0
- varReserved.vt == VT_I2 和 varReserved.iVal == 0
[out] ppClientContext
所傳回 IAzClientContext 物件的指標。
傳回值
如果函式成功，函式會傳回S_OK。
如果函式失敗，它會傳回 HRESULT 值，指出錯誤。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。
備註
可能的話，請呼叫 InitializeClientContextFromToken 函式，而不是 InitializeClientContextFromName。 InitializeClientContextFromName 嘗試擷取登入令牌中可用的資訊，而客戶端實際上已登入。 實際的登入令牌提供詳細資訊，例如登入類型和登入屬性，並反映用於登入的驗證套件行為。 InitializeClientContextFromToken 所建立的用戶端內容會使用登入令牌，而產生的用戶端內容比 InitializeClientContextFromName 所建立的用戶端內容更完整且精確。
DomainName 和 ClientName 參數必須結合才能代表 SidTypeUser。
支援的名稱格式與 LookupAccountName 函式所支援的名稱格式相同。
重要 應用程式不應該假設呼叫內容具有使用此函式的許可權。 AuthzInitializeContextFromSid 函式會讀取呼叫中所指定 SID 的 tokenGroupsGlobalAndUniversal 屬性，以判斷目前使用者的群組成員資格。 如果使用者的對象位於 Active Directory 中，呼叫內容必須具有用戶物件上 tokenGroupsGlobalAndUniversal 屬性的讀取許可權。 TokenGroupsGlobalAndUniversal 屬性的讀取存取權會授與 Windows 2000 相容存取 群組，但新的網域預設包含空 的 Windows 2000 兼容存取 群組，因為預設設定選取專案是 與 Windows 2000 和 Windows Server 2003 兼容的許可權。 因此，應用程式可能無法存取 tokenGroupsGlobalAndUniversal 屬性;在此情況下， AuthzInitializeContextFromSid 函式會失敗並ACCESS_DENIED。 使用此函式的應用程式應該正確處理此錯誤，並提供支援的檔案。 若要簡化授與帳戶查詢使用者群組信息的許可權，請新增需要查詢 Windows 授權存取群組資訊的帳戶。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | azroles.h |
| 程式庫 | Azroles.lib |
| Dll | Azroles.dll |
| 可轉散發套件 | Windows XP 上的 Windows Server 2003 系統管理工具套件 |