WSManPluginAuthzUserComplete 函式 (wsman.h)
從 WSManPluginAuthzUser 外掛程式進入點呼叫，並報告成功或失敗的使用者連線授權。
語法
DWORD WSManPluginAuthzUserComplete(
[in] WSMAN_SENDER_DETAILS *senderDetails,
[in] DWORD flags,
[in, optional] PVOID userAuthorizationContext,
[in, optional] HANDLE impersonationToken,
[in] BOOL userIsAdministrator,
[in] DWORD errorCode,
[in, optional] PCWSTR extendedErrorInformation
);
參數
[in] senderDetails
傳遞至 WSManPluginAuthzUser 外掛程式呼叫之WSMAN_SENDER_DETAILS結構的指標。
[in] flags
保留供未來使用。 必須設定為零。
[in, optional] userAuthorizationContext
指定用來協助追蹤使用者內容資訊的外掛程式定義內容。 此內容可以傳回至多個呼叫、呼叫這個呼叫或作業呼叫。 外掛程式會管理所有呼叫的參考計數。 如果用戶記錄逾時或重新授權，WinRM 基礎結構會呼叫 WSManPluginAuthzReleaseContext。
[in, optional] impersonationToken
指定使用者的身分識別。 此參數是傳遞至 senderDetails 的 clientToken。 如果外掛程式變更用戶內容，則應該傳回新的模擬令牌。
[in] userIsAdministrator
如果使用者是系統管理員，請將 設定為 TRUE 。 否則，此參數為 FALSE。
[in] errorCode
報告成功或失敗的授權。 如果授權成功，程式代碼應該 ERROR_SUCCESS。 如果使用者未獲授權執行作業，應該 ERROR_ACCESS_DENIED錯誤。 如果因任何其他原因而發生失敗，應該使用適當的錯誤碼。 來自此呼叫的任何錯誤都會以SOAP錯誤封包的形式傳回。
[in, optional] extendedErrorInformation
指定 XML 檔，其中包含需要向客戶端回報的任何額外錯誤資訊。 如果 errorCode是NO_ERROR，則會忽略此參數。 線程的使用者介面語言應該用於當地語系化。
傳回值
如果成功，此方法會 傳回ERROR_SUCCESS ;否則會 傳回ERROR_INVALID_PARAMETER。 如果傳回ERROR_INVALID_PARAMETER，senderDetails 參數為 NULL 或 flags 參數不是零。
備註
如果傳遞至 senderDetails 的模擬令牌不是應該執行作業的身分識別，或者沒有可用的模擬令牌，而且外掛程式會指定執行要求的新身分識別，外掛程式應該會傳回 WSMan 基礎結構在呼叫作業外掛程式之前用來模擬用戶端的新模擬 Token 。 如果在 senderDetails 中提供模擬令牌，而且外掛程式想要在該身分識別下執行作業，外掛程式應該將模擬令牌從 senderDetails 複製到 impersonationToken 參數。 如果外掛程式想要在 Internet Information Services 的內容下執行要求， (IIS) 主機進程， 則 impersonationToken 應該是 NULL。 如果 impersonationToken 為 NULL，線程會在呼叫作業外掛程式之前模擬進程令牌。
如果 userIsAdministrator 參數設定為 TRUE，則允許用戶檢視和刪除不同使用者所擁有的殼層。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 7 |
| 最低支援的伺服器 | Windows Server 2008 R2 |
| 目標平台 | Windows |
| 標頭 | wsman.h |
| 程式庫 | WsmSvc.lib |
| Dll | WsmSvc.dll |
| 可轉散發套件 | windows Server 2008 SP2 和 Windows Vista SP2 上的 Windows Management Framework |