WSMAN_PLUGIN_STARTUP Rückruffunktion (wsman.h)

Definiert den Startrückruf für das Plug-In. Da mehrere Anwendungen im selben Prozess gehostet werden können, kann diese Methode mehrmals aufgerufen werden, aber nur einmal für jede Anwendungsinitialisierung. Ein Plug-In kann innerhalb desselben Prozesses mehrmals initialisiert werden, aber nur einmal für jeden applicationIdentification-Wert . Der kontext, der von dieser Methode zurückgegeben wird, sollte anwendungsspezifisch sein. Der zurückgegebene Kontext wird an alle zukünftigen Plug-In-Aufrufe übergeben, die spezifisch für die Anwendung sind. Alle WinRM-Plug-Ins (Windows Remote Management) müssen diese Rückruffunktion implementieren.

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

Syntax

WSMAN_PLUGIN_STARTUP WsmanPluginStartup;

DWORD WsmanPluginStartup(
  DWORD flags,
  PCWSTR applicationIdentification,
  PCWSTR extraInfo,
  PVOID *pluginContext
)
{...}

Parameter

flags

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

applicationIdentification

Ein eindeutiger Bezeichner für die gehostete Anwendung. Für den Standard WinRM-Dienst ist der Standardwert wsman. Bei einem IIS-Host (InternetInformationsdienste) steht dieser Bezeichner im Zusammenhang mit dem Anwendungsendpunkt für diesen Host. Beispiel: wsman/MyCompany/MyApplication.

extraInfo

Eine Zeichenfolge, die Konfigurationsinformationen enthält, wenn Informationen gespeichert wurden, als das Plug-In registriert wurde. Wenn das Plug-In mithilfe der WinRM-Konfiguration registriert wird, kann das Plug-In zusätzliche Konfigurationsparameter hinzufügen, die während der Initialisierung nützlich sind, zu einem optionalen Knoten. Diese Informationen können besonders nützlich sein, wenn ein Plug-In in verschiedenen IIS-Hostingszenarien verwendet wird und während der Initialisierung eine etwas andere Laufzeitsemantik erfordert. Diese Zeichenfolge ist eine Kopie des XML aus der Konfiguration, sofern vorhanden. Andernfalls wird dieser Parameter auf NULL festgelegt.

pluginContext

Der Kontext für die spezifische Anwendungsinitialisierung. Dieser Kontext wird an alle anderen WinRM-Plug-In-Aufrufe übergeben, die diesem applicationIdentifier zugeordnet sind.

Rückgabewert

Die Methode gibt NO_ERROR zurück, wenn sie erfolgreich war. Andernfalls wird ein Fehlercode zurückgegeben. Wenn diese Methode einen Fehler zurückgibt, wird der WSManPluginShutdown-Einstiegspunkt nicht aufgerufen.

Anforderungen

Anforderung	Wert
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