IHttpUser 介面
提供使用者的相關要求特定資訊。 此資訊包括認證和角色型授權等資料。
Syntax
class IHttpUser
方法
下表列出 介面所 IHttpUser 公開的方法。
| 主題 | 描述 |
|---|---|
| DereferenceUser | 遞減使用者內部參考計數。 |
| GetAuthenticationType | 傳回要求驗證類型。 |
| GetImpersonationToken | 傳回使用者模擬權杖。 |
| GetPassword | 傳回使用者密碼。 |
| GetPrimaryToken | 傳回主要使用者權杖。 |
| GetRemoteUserName | 傳回遠端使用者名稱。 |
| GetUserName | 傳回使用者名稱。 |
| GetUserVariable | 依名稱傳回自訂使用者資料。 |
| IsInRole | 傳回值，指出使用者是否獲得具名角色的授權。 |
| ReferenceUser | 遞增使用者內部參考計數。 |
| SupportsIsInRole | 傳回值，指出是否為使用者啟用角色支援。 |
衍生類別
此介面不包含任何衍生類別。
備註
您可以藉由呼叫IHttpCoNtext：：GetUser方法，從IHttpCoNtext指標擷取 IHttpUser 指標。 若要取得這些介面的存取權，請參閱逐步解說 ：使用機器碼建立Request-Level HTTP 模組。
範例
下列程式碼範例示範如何建立 HTTP 模組，以清除回應標頭和本文，然後將使用者資訊以 XML 檔的形式傳回用戶端。
上述程式碼會撰寫類似下列回應資料流程的 XML。
<?xml version="1.0" ?>
<user
userName="DOMAIN\user"
remoteName=" DOMAIN\user"
passWord="[hidden]"
authType="Negotiate"
impersonationToken="valid"
primaryToken="valid"
supportsRoles="true"
isInRole="false"
userVariable="NULL" />
您的模組必須匯出 RegisterModule 函式。 您可以為專案建立模組定義 (.def) 檔案，或使用 參數編譯模組 /EXPORT:RegisterModule 來匯出此函式。 如需詳細資訊，請參閱 逐步解說：使用機器碼建立 Request-Level HTTP 模組。
您可以選擇性地使用呼叫慣例編譯器代碼， __stdcall (/Gz) 而不是明確宣告每個函式的呼叫慣例。
規格需求
| 類型 | 描述 |
|---|---|
| Client | - Windows Vista 上的 IIS 7.0 - Windows 7 上的 IIS 7.5 - Windows 8 上的 IIS 8.0 - Windows 10上的 IIS 10.0 |
| 伺服器 | - Windows Server 2008 上的 IIS 7.0 - Windows Server 2008 R2 上的 IIS 7.5 - Windows Server 2012 上的 IIS 8.0 - Windows Server 2012 R2 上的 IIS 8.5 - Windows Server 2016上的 IIS 10.0 |
| 產品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 - IIS Express 7.5、IIS Express 8.0、IIS Express 10.0 |
| 標頭 | Httpserv.h |