WSManPluginAuthzOperationComplete-Funktion (wsman.h)

Wird vom Einstiegspunkt des WSManPluginAuthzOperation-Plug-Ins aufgerufen. Sie meldet entweder eine erfolgreiche oder fehlgeschlagene Autorisierung für einen Benutzervorgang.

Syntax

DWORD WSManPluginAuthzOperationComplete(
  [in]           WSMAN_SENDER_DETAILS *senderDetails,
  [in]           DWORD                flags,
  [in, optional] PVOID                userAuthorizationContext,
  [in]           DWORD                errorCode,
  [in, optional] PCWSTR               extendedErrorInformation
);

Parameter

[in] senderDetails

Ein Zeiger auf die WSMAN_SENDER_DETAILS-Struktur , die an den Aufruf des WSManPluginAuthzOperation-Plug-Ins übergeben wurde.

[in] flags

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

[in, optional] userAuthorizationContext

Gibt einen vom Plug-In definierten Kontext an, der verwendet wird, um Benutzerkontextinformationen nachzuverfolgen. Dieser Kontext kann für mehrere Aufrufe, für diesen Aufruf oder für einen Vorgangsaufruf zurückgegeben werden. Das Plug-In verwaltet die Verweiszählung für alle Aufrufe. Wenn ein Zeitüberschreitung des Benutzerdatensatzes oder eine erneute Autorisierung erforderlich ist, ruft die WinRM-Infrastruktur (WinRM) WSManPluginAuthzReleaseContext auf.

[in] errorCode

Meldet entweder eine erfolgreiche oder fehlgeschlagene Autorisierung. Wenn die Autorisierung erfolgreich ist, sollte der Code ERROR_SUCCESS werden. Wenn der Benutzer nicht zum Ausführen des Vorgangs autorisiert ist, sollte der Fehler ERROR_ACCESS_DENIED werden. Wenn ein Fehler aus einem anderen Grund auftritt, sollte ein entsprechender Fehlercode verwendet werden. Alle Fehler aus diesem Aufruf werden als SOAP-Fehlerpaket (Simple Object Access Protocol) 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 parameter senderDetailsNULL oder der flags-Parameter war nicht 0.

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