ITSGAuthorizeResourceSink::OnChannelAuthorized-Methode (tsgpolicyengine.h)
Benachrichtigt Remotedesktopgateway (RD-Gateway) über das Ergebnis eines Versuches, eine Ressource zu autorisieren.
Syntax
HRESULT OnChannelAuthorized(
[in] HRESULT hrIn,
[in] GUID mainSessionId,
[in] int subSessionId,
[in] BSTR *allowedResourceNames,
[in] ULONG numAllowedResourceNames,
[in] BSTR *failedResourceNames,
[in] ULONG numFailedResourceNames
);
Parameter
[in] hrIn
Das Ergebnis des Autorisierungsversuchs. Geben Sie S_OK an, um anzugeben, dass der Versuch erfolgreich war. Geben Sie einen beliebigen anderen Wert an, um anzugeben, dass der Versuch fehlgeschlagen ist.
[in] mainSessionId
Ein eindeutiger Bezeichner, der der Verbindungsanforderung vom RD-Gateway zugewiesen ist.
[in] subSessionId
Ein eindeutiger Bezeichner, der der Untersession vom RD-Gateway zugewiesen ist. Eine Untersession ist eine Sitzung, die aus einer anderen Sitzung gestartet wird.
[in] allowedResourceNames
Ein Zeiger auf einen BSTR , der eine Liste der Ressourcen enthält, die erfolgreich autorisiert wurden.
[in] numAllowedResourceNames
Die Anzahl der Ressourcen, auf die vom parameter allowedResourceNames verwiesen wird. Wenn die Funktion erfolgreich ist, muss es sich bei diesem Parameter um einen oder mehrere Parameter handelt.
[in] failedResourceNames
Ein Zeiger auf einen BSTR , der eine Liste von Ressourcen enthält, bei denen die Autorisierung fehlgeschlagen ist.
[in] numFailedResourceNames
Die Anzahl der Ressourcen, auf die vom failedResourceNames-Parameter verwiesen wird.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Sie können diese Methode über Ihre Implementierung von AuthorizeResource aufrufen. Wenn die Autorisierung mehr als eine Sekunde benötigt, empfehlen wir, einen separaten Thread zu starten, um die Authentifizierung durchzuführen.
Ein Beispiel, das die OnChannelAuthorized-Methode verwendet, finden Sie im Beispiel für die pluggable Authentifizierung und Autorisierung des Remotedesktopgateways .
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 |
| Zielplattform | Windows |
| Kopfzeile | tsgpolicyengine.h |