WSMAN_PLUGIN_AUTHORIZE_QUERY_QUOTA Rückruffunktion (wsman.h)

Artikel
08/28/2023

Ruft Kontingentinformationen für den Benutzer ab, nachdem eine Verbindung autorisiert wurde. Diese Methode wird nur aufgerufen, wenn die Konfiguration angibt, dass Kontingente innerhalb des Autorisierungs-Plug-Ins aktiviert sind.

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

Syntax

WSMAN_PLUGIN_AUTHORIZE_QUERY_QUOTA WsmanPluginAuthorizeQueryQuota;

void WsmanPluginAuthorizeQueryQuota(
  [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 Benutzers angibt.

[in] flags

Für die zukünftige Verwendung reserviert. Muss Null sein.

Rückgabewert

Keine

Bemerkungen

Das Kontingent wird beim ersten Aufruf von einem bestimmten Benutzer abgefragt und erst nach dem Timeout des Benutzerdatensatzes aufgrund eines Leerlauftimeouts der Aktivität oder bis ein systemweiter Konfigurationszeitraum überschritten wird.

Das Plug-In muss die WSManPluginAuthzQueryQuotaComplete-Funktion aufrufen, um den Vorgang zu beenden, unabhängig davon, ob das Plug-In die Anforderung ausführen kann oder nicht. Bei erfolgreicher Ausführung sollte das Plug-In eine Reihe von Kontingentinformationen bereitstellen, die für diesen bestimmten Benutzer relevant sind. Wenn das Plug-In die Anforderung aus irgendeinem Grund nicht verarbeitet, sollte ein entsprechender Fehler über die Rückrufmethode aufgezeichnet werden, und der Fehler wird nach Möglichkeit als SOAP-Fehler (Simple Object Access Protocol) an den Client weitergegeben. Andernfalls handelt es sich bei dem Fehler um einen leeren HTTP 500-status-Fehler.

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

Share via