WSMAN_PLUGIN_STARTUP función de devolución de llamada (wsman.h)

Define la devolución de llamada de inicio del complemento. Dado que se pueden hospedar varias aplicaciones en el mismo proceso, se puede llamar a este método varias veces, pero solo una vez para cada inicialización de la aplicación. Un complemento se puede inicializar más de una vez dentro del mismo proceso, pero solo una vez para cada valor applicationIdentification . El contexto que se devuelve de este método debe ser específico de la aplicación. El contexto devuelto se pasará a todas las futuras llamadas de complemento específicas de la aplicación. Todos los complementos de Administración remota de Windows (WinRM) deben implementar esta función de devolución de llamada.

El nombre del punto de entrada dll para este método debe ser WSManPluginStartup.

Sintaxis

WSMAN_PLUGIN_STARTUP WsmanPluginStartup;

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

Parámetros

flags

Reservado para uso futuro. Debe ser cero.

applicationIdentification

Identificador único de la aplicación hospedada. Para el servicio WinRM principal, el valor predeterminado es wsman. Para un host de Internet Information Services (IIS), este identificador está relacionado con el punto de conexión de la aplicación para ese host. Por ejemplo, wsman/MyCompany/MyApplication.

extraInfo

Cadena que contiene información de configuración, si se almacenó alguna información cuando se registró el complemento. Cuando el complemento se registra mediante la configuración de WinRM, el complemento puede agregar parámetros de configuración adicionales que son útiles durante la inicialización a un nodo opcional. Esta información puede ser especialmente útil si se usa un complemento en diferentes escenarios de hospedaje de IIS y requiere una semántica en tiempo de ejecución ligeramente diferente durante la inicialización. Esta cadena es una copia del XML de la configuración, si hay una presente. De lo contrario, este parámetro se establece en NULL.

pluginContext

Contexto para la inicialización de la aplicación específica. Este contexto se pasa a todas las demás llamadas de complemento WinRM asociadas a este applicationIdentifier.

Valor devuelto

El método devuelve NO_ERROR si se realizó correctamente; de lo contrario, devuelve un código de error. Si este método devuelve un error, no se llamará al punto de entrada WSManPluginShutdown .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7
Servidor mínimo compatible	Windows Server 2008 R2
Plataforma de destino	Windows
Encabezado	wsman.h
Redistribuible	Windows Management Framework en Windows Server 2008 con SP2, Windows Vista con SP1 y Windows Vista con SP2