IWTSProtocolLogonErrorRedirector：：RedirectLogonError 方法 (wtsprotocol.h)

發行項
08/28/2023

[IWTSProtocolLogonErrorRedirector：：RedirectLogonError 已不再可供 Windows Server 2012 使用。請改用 IWRdsProtocolLogonErrorRedirector：：RedirectLogonError。]

查詢通訊協定，以取得回應登入錯誤的動作。 Remote Desktop Services 服務會呼叫 RedirectStatus 方法，以查詢通訊協定，以回應登入錯誤所採取的動作。

語法

HRESULT RedirectLogonError(
  [in]  LONG                                ntsStatus,
  [in]  LONG                                ntsSubstatus,
  [in]  LPCWSTR                             pszCaption,
  [in]  LPCWSTR                             pszMessage,
  [in]  UINT                                uType,
  [out] WTS_LOGON_ERROR_REDIRECTOR_RESPONSE *pResponse
);

參數

[in] ntsStatus

包含登入失敗相關資訊的整數。這可以是下列其中一個值。

STATUS_QUOTA_EXCEEDED

記憶體配額不足，無法配置驗證套件所傳回的輸出緩衝區。

STATUS_ACCOUNT_RESTRICTION

使用者帳戶和密碼是合法的，但使用者帳戶有一項限制，目前會防止登入。如需詳細資訊，請參閱 ntsSubstatus 參數。

STATUS_BAD_VALIDATION_CLASS

驗證套件無法辨識所提供的驗證資訊。

STATUS_LOGON_FAILURE

登入嘗試失敗。未指定失敗的原因，但一般原因包括拼錯的使用者名稱和拼字錯誤的密碼。

STATUS_NO_LOGON_SERVERS

沒有網域控制站可供服務驗證要求。

STATUS_NO_SUCH_PACKAGE

LSA 無法辨識指定的驗證套件。

[in] ntsSubstatus

整數，包含登入嘗試失敗原因的相關資訊。只有在使用者的帳戶資訊有效且拒絕登入時，才會設定此值。這可以包含下列其中一個值。

STATUS_INVALID_LOGON_HOURS

使用者帳戶有時間限制，目前無法用來登入。

STATUS_INVALID_WORKSTATION

使用者帳戶有工作站限制，無法用來從目前的工作站登入。

STATUS_PASSWORD_EXPIRED

使用者帳戶密碼已過期。

STATUS_ACCOUNT_DISABLED

使用者帳戶目前已停用，無法用來登入。

[in] pszCaption

字串的指標，其中包含訊息方塊標題。

[in] pszMessage

包含訊息之字串的指標。

[in] uType

包含訊息方塊類型的整數。如需詳細資訊，請參閱 MessageBox 函式。

[out] pResponse

WTS_LOGON_ERROR_REDIRECTOR_RESPONSE 列舉的指標，指定遠端桌面服務對登入錯誤的慣用回應。

傳回值

當您實作此方法時，如果函式成功，則傳回S_OK。如果失敗，請傳回 指出錯誤的 HRESULT 值。如需常見錯誤碼的清單，請參閱一般 HRESULT 值。

規格需求


最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2008 R2
目標平台	Windows
標頭	wtsprotocol.h

另請參閱

IWTSProtocolLogonErrorRedirector

共用方式為