IWTSProtocolLogonErrorRedirector::RedirectLogonError-Methode (wtsprotocol.h)

[IWTSProtocolLogonErrorRedirector::RedirectLogonError ist ab Windows Server 2012 nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolLogonErrorRedirector::RedirectLogonError.]

Fragt das Protokoll nach der Aktion ab, die als Reaktion auf einen Anmeldefehler ausgeführt werden soll. Die RedirectStatus-Methode wird vom Remotedesktopdienstedienst aufgerufen, um das Protokoll für die Aktion abzufragen, die als Reaktion auf einen Anmeldefehler ausgeführt werden soll.

Syntax

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

Parameter

[in] ntsStatus

Eine ganze Zahl, die Informationen zum Anmeldefehler enthält. Dies kann einer der folgenden Werte sein.

STATUS_QUOTA_EXCEEDED

Das Speicherkontingent reicht nicht aus, um den vom Authentifizierungspaket zurückgegebenen Ausgabepuffer zuzuweisen.

STATUS_ACCOUNT_RESTRICTION

Das Benutzerkonto und das Kennwort sind legitim, aber das Benutzerkonto hat eine Einschränkung, die die Anmeldung zu diesem Zeitpunkt verhindert. Weitere Informationen finden Sie im NtsSubstatus-Parameter .

STATUS_BAD_VALIDATION_CLASS

Die bereitgestellten Authentifizierungsinformationen werden vom Authentifizierungspaket nicht erkannt.

STATUS_LOGON_FAILURE

Der Anmeldeversuch ist fehlgeschlagen. Der Grund für den Fehler wird nicht angegeben, aber typische Gründe sind falsch geschriebene Benutzernamen und falsch geschriebene Kennwörter.

STATUS_NO_LOGON_SERVERS

Für die Authentifizierungsanforderung stehen keine Domänencontroller zur Verfügung.

STATUS_NO_SUCH_PACKAGE

Das angegebene Authentifizierungspaket wird von der LSA nicht erkannt.

[in] ntsSubstatus

Eine ganze Zahl, die Informationen darüber enthält, warum ein Anmeldeversuch fehlgeschlagen ist. Dieser Wert wird nur festgelegt, wenn die Kontoinformationen des Benutzers gültig sind und die Anmeldung abgelehnt wird. Dies kann einen der folgenden Werte enthalten.

STATUS_INVALID_LOGON_HOURS

Das Benutzerkonto hat Zeiteinschränkungen und kann derzeit nicht zum Anmelden verwendet werden.

STATUS_INVALID_WORKSTATION

Das Benutzerkonto hat Arbeitsstationseinschränkungen und kann nicht zum Anmelden von der aktuellen Arbeitsstation verwendet werden.

STATUS_PASSWORD_EXPIRED

Das Benutzerkontokennwort ist abgelaufen.

STATUS_ACCOUNT_DISABLED

Das Benutzerkonto ist derzeit deaktiviert und kann nicht zum Anmelden verwendet werden.

[in] pszCaption

Ein Zeiger auf eine Zeichenfolge, die das Meldungsfeld Untertitel enthält.

[in] pszMessage

Ein Zeiger auf eine Zeichenfolge, die die Nachricht enthält.

[in] uType

Eine ganze Zahl, die den Meldungsfeldtyp enthält. Weitere Informationen finden Sie in der MessageBox-Funktion .

[out] pResponse

Ein Zeiger auf eine WTS_LOGON_ERROR_REDIRECTOR_RESPONSE-Enumeration , die für den Remotedesktopdienstedienst die bevorzugte Antwort auf den Anmeldefehler angibt.

Rückgabewert

Wenn Sie diese Methode implementieren, geben Sie S_OK zurück, wenn die Funktion erfolgreich ist. Wenn ein Fehler auftritt, geben Sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Anforderungen

Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 R2
Zielplattform	Windows
Kopfzeile	wtsprotocol.h

Weitere Informationen

IWTSProtocolLogonErrorRedirector