WSManPluginAuthzUserComplete-Funktion (wsman.h)

  • Artikel

Wird vom Einstiegspunkt des WSManPluginAuthzUser-Plug-Ins aufgerufen und meldet entweder eine erfolgreiche oder fehlgeschlagene Benutzerverbindungsautorisierung.

Syntax

DWORD WSManPluginAuthzUserComplete(
  [in]           WSMAN_SENDER_DETAILS *senderDetails,
  [in]           DWORD                flags,
  [in, optional] PVOID                userAuthorizationContext,
  [in, optional] HANDLE               impersonationToken,
  [in]           BOOL                 userIsAdministrator,
  [in]           DWORD                errorCode,
  [in, optional] PCWSTR               extendedErrorInformation
);

Parameter

[in] senderDetails

Ein Zeiger auf die WSMAN_SENDER_DETAILS-Struktur , die an den WSManPluginAuthzUser-Plug-In-Aufruf übergeben wurde.

[in] flags

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

[in, optional] userAuthorizationContext

Gibt einen vom Plug-In definierten Kontext an, der zum Nachverfolgen von Benutzerkontextinformationen verwendet wird. Dieser Kontext kann für mehrere Aufrufe, diesen Aufruf oder einen Vorgangsaufruf zurückgegeben werden. Das Plug-In verwaltet die Verweiszählung für alle Aufrufe. Wenn für den Benutzerdatensatz ein Timesout oder eine erneute Autorisierung erforderlich ist, ruft die WinRM-Infrastruktur WSManPluginAuthzReleaseContext auf.

[in, optional] impersonationToken

Gibt die Identität des Benutzers an. Dieser Parameter ist der clientToken , der an senderDetails übergeben wurde. Wenn das Plug-In den Benutzerkontext ändert, sollte ein neues Identitätswechseltoken zurückgegeben werden.

Hinweis Dieses Token wird freigegeben, nachdem der Vorgang abgeschlossen wurde.
 

[in] userIsAdministrator

Legen Sie auf TRUE fest, wenn der Benutzer ein Administrator ist. Andernfalls ist dieser Parameter FALSE.

[in] errorCode

Meldet entweder eine erfolgreiche oder eine fehlgeschlagene Autorisierung. Wenn die Autorisierung erfolgreich ist, sollte der Code ERROR_SUCCESS werden. Wenn der Benutzer nicht autorisiert ist, den Vorgang auszuführen, sollte der Fehler ERROR_ACCESS_DENIED werden. Wenn ein Fehler aus einem anderen Grund auftritt, sollte ein geeigneter Fehlercode verwendet werden. Alle Fehler aus diesem Aufruf werden als SOAP-Fehlerpaket zurückgesendet.

[in, optional] extendedErrorInformation

Gibt ein XML-Dokument an, das zusätzliche Fehlerinformationen enthält, die an den Client gemeldet werden müssen. Dieser Parameter wird ignoriert, wenn errorCodeNO_ERROR ist. Die Sprache der Benutzeroberfläche des Threads sollte für die Lokalisierung verwendet werden.

Rückgabewert

Die -Methode gibt ERROR_SUCCESS zurück, wenn sie erfolgreich war. Andernfalls wird ERROR_INVALID_PARAMETER zurückgegeben. Wenn ERROR_INVALID_PARAMETER zurückgegeben wird, lautete entweder der senderDetails-ParameterNULL , oder der Flags-Parameter war nicht null.

Hinweise

Wenn das an senderDetails übergebene Identitätswechseltoken nicht die Identität ist, mit der der Vorgang ausgeführt werden soll, oder wenn kein Identitätswechseltoken verfügbar ist und das Plug-In eine neue Identität zum Ausführen der Anforderung angibt, sollte das Plug-In den neuen Identitätswechseltoken zurückgeben, den die WSMan-Infrastruktur zum Annehmen der Identität des Clients vor dem Aufrufen des Vorgangs-Plug-Ins verwendet. Wenn in senderDetails ein Identitätswechseltoken bereitgestellt wird und das Plug-In den Vorgang unter dieser Identität ausführen möchte, sollte das Plug-In das Identitätswechseltoken aus senderDetails in den ImpersonationToken-Parameter kopieren. Wenn das Plug-In die Anforderung im Kontext des IIS-Hostprozesses (Internet Information Services) ausführen möchte, sollte der IdentitätswechseltokenNULL sein. Wenn der IdentitätswechselNULL ist, nimmt der Thread die Identität des Prozesstokens an, bevor er das Vorgangs-Plug-In aufruft.

Wenn der userIsAdministrator-Parameter auf TRUE festgelegt ist, kann der Benutzer Shells im Besitz verschiedener Benutzer anzeigen und löschen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7
Unterstützte Mindestversion (Server) Windows Server 2008 R2
Zielplattform Windows
Kopfzeile wsman.h
Bibliothek WsmSvc.lib
DLL WsmSvc.dll
Verteilbare Komponente Windows Management Framework unter Windows Server 2008 mit SP2 und Windows Vista mit SP2