WSMAN_PLUGIN_STARTUP função de retorno de chamada (wsman.h)

Define o retorno de chamada de inicialização para o plug-in. Como vários aplicativos podem ser hospedados no mesmo processo, esse método pode ser chamado várias vezes, mas apenas uma vez para cada inicialização de aplicativo. Um plug-in pode ser inicializado mais de uma vez dentro do mesmo processo, mas apenas uma vez para cada valor applicationIdentification . O contexto retornado desse método deve ser específico do aplicativo. O contexto retornado será passado para todas as chamadas de plug-in futuras específicas para o aplicativo. Todos os plug-ins do WinRM (Gerenciamento Remoto do Windows) devem implementar essa função de retorno de chamada.

O nome do ponto de entrada da DLL para esse método deve ser WSManPluginStartup.

Sintaxe

WSMAN_PLUGIN_STARTUP WsmanPluginStartup;

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

Parâmetros

flags

Reservado para uso futuro. Deve ser zero.

applicationIdentification

Um identificador exclusivo para o aplicativo hospedado. Para o main serviço WinRM, o padrão é wsman. Para um host dos Serviços de Informações da Internet (IIS), esse identificador está relacionado ao ponto de extremidade do aplicativo desse host. Por exemplo, wsman/MyCompany/MyApplication.

extraInfo

Uma cadeia de caracteres que contém informações de configuração, se alguma informação foi armazenada quando o plug-in foi registrado. Quando o plug-in é registrado usando a configuração do WinRM, o plug-in pode adicionar parâmetros de configuração extras que são úteis durante a inicialização a um nó opcional. Essas informações podem ser especialmente úteis se um plug-in for usado em diferentes cenários de hospedagem do IIS e exigir semântica de tempo de execução ligeiramente diferente durante a inicialização. Essa cadeia de caracteres é uma cópia do XML da configuração, se houver uma. Caso contrário, esse parâmetro será definido como NULL.

pluginContext

O contexto para a inicialização específica do aplicativo. Esse contexto é passado para todas as outras chamadas de plug-in WinRM associadas a esse applicationIdentifier.

Retornar valor

O método retornará NO_ERROR se tiver êxito; caso contrário, ele retorna um código de erro. Se esse método retornar um erro, o ponto de entrada WSManPluginShutdown não será chamado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7
Servidor mínimo com suporte	Windows Server 2008 R2
Plataforma de Destino	Windows
Cabeçalho	wsman.h
Redistribuível	Windows Management Framework no Windows Server 2008 com SP2, Windows Vista com SP1 e Windows Vista com SP2