IHttpUser：：GetUserName 方法

傳回使用者名稱。

語法

virtual PCWSTR GetUserName(  
   VOID  
) = 0;  

參數

此方法不會採用任何參數。

傳回值

包含使用者名稱的常數 Null 終止 Unicode 字串指標。

備註

傳回的值取決於驗證類型。 驗證類型是從 GetAuthenticationType 方法傳回。

下表顯示具有相關聯使用者名稱值或模式的驗證類型。

驗證類型	使用者名稱
匿名	空字串
基本	域\使用者
Digest	domain\username 或 username
表單	username
Windows	域\使用者

實作者的注意事項

IHttpUser 實作者負責使用此資料的記憶體管理;因此，當不再需要動態記憶體配置時， IHttpUser 使用動態記憶體配置的實作必須釋放或呼叫 deletePCWSTR 指標。

來電者的注意事項

IHttpUser 實作者負責使用此資料的記憶體管理;因此，當不再需要此資料時， IHttpUser 用戶端不得釋放或呼叫 delete 傳 PCWSTR 回的指標。 此外，用戶端不得將此資料轉換成不是 const 或變更此 PCWSTR 所參考記憶體狀態的指標，否則會擲回存取違規，否則資料將會變成無效。

範例

下列程式碼範例示範如何建立 HTTP 模組，以清除回應標頭和本文，然後將使用者資訊傳回用戶端做為 XML 檔。

上述程式碼會將 XML 寫入回應資料流程，如下所示。

<?xml version="1.0" ?>  
<user userName="DOMAIN\user" />  

您的模組必須匯出 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

另請參閱

IHttpUser 介面
IHttpUser：：GetPassword 方法
IHttpUser：：GetRemoteUserName 方法