WSMAN_PLUGIN_AUTHORIZE_USER Rückruffunktion (wsman.h)

Autorisiert eine Verbindung. Das Plug-In sollte überprüfen, ob dieser Benutzer Vorgänge ausführen darf. Wenn der Benutzer Vorgänge ausführen darf, muss das Plug-In einen Erfolg melden. Wenn der Benutzer keinen Vorgang ausführen darf, muss ein Fehler zurückgegeben werden.

Jede neue Verbindung muss nicht autorisiert werden. Nachdem ein Benutzer zum Herstellen einer Verbindung autorisiert wurde, wird ein Benutzerdatensatz erstellt, um die Aktivitäten des Benutzers nachzuverfolgen. Während dieser Datensatz vorhanden ist, werden alle neuen Verbindungen automatisch autorisiert. Der Benutzerdatensatz wird nach einer konfigurierbaren Zeitspanne timeout ausgeführt, nachdem keine Aktivität erkannt wurde.

Der NAME des DLL-Einstiegspunkts für diese Methode muss WSManPluginAuthzUser sein.

Syntax

WSMAN_PLUGIN_AUTHORIZE_USER WsmanPluginAuthorizeUser;

void WsmanPluginAuthorizeUser(
  [in] PVOID pluginContext,
  [in] WSMAN_SENDER_DETAILS *senderDetails,
  [in] DWORD flags
)
{...}

Parameter

[in] pluginContext

Gibt den Kontext an, der von einem Aufruf von WSManPluginStartup zurückgegeben wurde. Dieser Parameter stellt eine bestimmte Anwendungsinitialisierung eines WinRM-Plug-Ins dar.

[in] senderDetails

Ein Zeiger auf die WSMAN_SENDER_DETAILS-Struktur , die die Identifikationsinformationen des zu autorisierenden Benutzers angibt.

[in] flags

Für die zukünftige Verwendung reserviert. Muss auf 0 festgelegt werden.

Rückgabewert

Keine

Bemerkungen

Das Plug-In muss WSManPluginAuthzUserComplete aufrufen, um entweder zu melden, dass der Benutzer erfolgreich mit NO_ERROR autorisiert wurde oder dass der Benutzer nicht mit ERROR_ACCESS_DENIED autorisiert wurde. Es sollte ein ERROR_WSMAN_REDIRECT_REQUIRED Fehler gemeldet werden, wenn für diesen Benutzer eine HTTP-Umleitung erforderlich ist, und der neue HTTP-URI sollte in extendedErrorInformation der WSManPluginAuthzUserComplete-Methode aufgezeichnet werden. Alle anderen Fehler melden einen Fehler an den Client, aber es werden keine spezifischen Informationen gemeldet.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7
Unterstützte Mindestversion (Server)	Windows Server 2008 R2
Zielplattform	Windows
Kopfzeile	wsman.h
Verteilbare Komponente	Windows Management Framework unter Windows Server 2008 mit SP2, Windows Vista mit SP1 und Windows Vista mit SP2