共用方式為


IHttpUser::GetUserVariable 方法

依名稱傳回自訂使用者資料。

語法

virtual PVOID GetUserVariable(  
   IN PCSTR pszVariableName  
) = 0;  

參數

pszVariableName
[IN]常數 Null 終止字串的指標,其中包含要擷取之資料的變數名稱。

傳回值

void包含上播自訂資料的指標。

備註

預設值為 HTTP_USER_VARIABLE_SID ,定義于 Httpserv.h 標頭檔中。

實作者的注意事項

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

來電者的注意事項

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

範例

下列程式碼範例示範如何建立 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 介面