WSMAN_PLUGIN_STARTUP fonction de rappel (wsman.h)

Définit le rappel de démarrage pour le plug-in. Étant donné que plusieurs applications peuvent être hébergées dans le même processus, cette méthode peut être appelée plusieurs fois, mais une seule fois pour chaque initialisation d’application. Un plug-in peut être initialisé plusieurs fois dans le même processus, mais une seule fois pour chaque valeur applicationIdentification . Le contexte retourné par cette méthode doit être spécifique à l’application. Le contexte retourné sera transmis à tous les futurs appels de plug-in spécifiques à l’application. Tous les plug-ins Windows Remote Management (WinRM) doivent implémenter cette fonction de rappel.

Le nom du point d’entrée DLL pour cette méthode doit être WSManPluginStartup.

Syntaxe

WSMAN_PLUGIN_STARTUP WsmanPluginStartup;

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

Paramètres

flags

Réservé pour un usage futur. Doit être zéro.

applicationIdentification

Identificateur unique de l’application hébergée. Pour le main service WinRM, la valeur par défaut est wsman. Pour un hôte IIS (Internet Information Services), cet identificateur est lié au point de terminaison d’application de cet hôte. Par exemple, wsman/MyCompany/MyApplication.

extraInfo

Chaîne qui contient des informations de configuration, si des informations ont été stockées lors de l’inscription du plug-in. Lorsque le plug-in est inscrit à l’aide de la configuration WinRM, le plug-in peut ajouter des paramètres de configuration supplémentaires utiles lors de l’initialisation à un nœud facultatif. Ces informations peuvent être particulièrement utiles si un plug-in est utilisé dans différents scénarios d’hébergement IIS et nécessite une sémantique légèrement différente au moment de l’exécution pendant l’initialisation. Cette chaîne est une copie du code XML de la configuration, le cas échéant. Sinon, ce paramètre est défini sur NULL.

pluginContext

Contexte de l’initialisation d’application spécifique. Ce contexte est transmis à tous les autres appels de plug-in WinRM associés à cette applicationIdentifier.

Valeur retournée

La méthode retourne NO_ERROR si elle a réussi ; sinon, elle retourne un code d’erreur. Si cette méthode retourne une erreur, le point d’entrée WSManPluginShutdown n’est pas appelé.

Configuration requise