IHttpUser::GetUserVariable 方法
依名稱傳回自訂使用者資料。
語法
virtual PVOID GetUserVariable(
IN PCSTR pszVariableName
) = 0;
參數
pszVariableName
[IN]常數 Null 終止字串的指標,其中包含要擷取之資料的變數名稱。
傳回值
void
包含上播自訂資料的指標。
備註
預設值為 HTTP_USER_VARIABLE_SID
,定義于 Httpserv.h 標頭檔中。
實作者的注意事項
IHttpUser 實作者負責使用此資料的記憶體管理;因此, IHttpUser
使用動態記憶體配置的實作者必須在不再需要時釋放或 delete
void
指標。
來電者的注意事項
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 |