Skip to content

Latest commit

 

History

History
77 lines (61 loc) · 3.55 KB

nc-wsman-wsman_plugin_startup.md

File metadata and controls

77 lines (61 loc) · 3.55 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NC:wsman.WSMAN_PLUGIN_STARTUP
WSMAN_PLUGIN_STARTUP (wsman.h)
Defines the startup callback for the plug-in.
WSMAN_PLUGIN_STARTUP
WSMAN_PLUGIN_STARTUP callback
WSMAN_PLUGIN_STARTUP callback function [Windows Remote Management]
WSManPluginStartup
winrm.wsman_plugin_startup
wsman/WSMAN_PLUGIN_STARTUP
winrm\wsman_plugin_startup.htm
winrm
b3123f52-880b-4d14-a5a2-77c5924de99d
12/05/2018
WSMAN_PLUGIN_STARTUP, WSMAN_PLUGIN_STARTUP callback, WSMAN_PLUGIN_STARTUP callback function [Windows Remote Management], WSManPluginStartup, winrm.wsman_plugin_startup, wsman/WSMAN_PLUGIN_STARTUP
wsman.h
Windows
Windows 7
Windows Server 2008 R2
Windows
Windows Management Framework on Windows Server 2008 with SP2, Windows Vista with SP1, and Windows Vista with SP2
19H1
WSMAN_PLUGIN_STARTUP
wsman/WSMAN_PLUGIN_STARTUP
c++
APIRef
kbSyntax
UserDefined
Wsman.h
WSMAN_PLUGIN_STARTUP

WSMAN_PLUGIN_STARTUP callback function

-description

Defines the startup callback for the plug-in. Because multiple applications can be hosted in the same process, this method can be called multiple times, but only once for each application initialization. A plug-in can be initialized more than once within the same process but only once for each applicationIdentification value. The context that is returned from this method should be application specific. The returned context will be passed into all future plug-in calls that are specific to the application. All Windows Remote Management (WinRM) plug-ins must implement this callback function.

The DLL entry point name for this method must be WSManPluginStartup.

-parameters

-param flags

Reserved for future use. Must be zero.

-param applicationIdentification

A unique identifier for the hosted application. For the main WinRM service, the default is wsman. For an Internet Information Services (IIS) host, this identifier is related to the application endpoint for that host. For example, wsman/MyCompany/MyApplication.

-param extraInfo

A string that contains configuration information, if any information was stored when the plug-in was registered. When the plug-in is registered using the WinRM configuration, the plug-in can add extra configuration parameters that are useful during initialization to an optional node. This information can be especially useful if a plug-in is used in different IIS hosting scenarios and requires slightly different run-time semantics during initialization. This string is a copy of the XML from the configuration, if one is present. Otherwise, this parameter is set to NULL.

-param pluginContext

The context for the specific application initialization. This context is passed through to all other WinRM plug-in calls that are associated with this applicationIdentifier.

-returns

The method returns NO_ERROR if it succeeded; otherwise, it returns an error code. If this method returns an error, the WSManPluginShutdown entry point will not be called.