WSMAN_PLUGIN_STARTUP funzione di callback (wsman.h)

Articolo
03/04/2024

Definisce il callback di avvio per il plug-in. Poiché più applicazioni possono essere ospitate nello stesso processo, questo metodo può essere chiamato più volte, ma una sola volta per ogni inizializzazione dell'applicazione. Un plug-in può essere inizializzato più volte all'interno dello stesso processo, ma una sola volta per ogni valore applicationIdentification . Il contesto restituito da questo metodo deve essere specifico dell'applicazione. Il contesto restituito verrà passato a tutte le chiamate plug-in future specifiche dell'applicazione. Tutti i plug-in di Gestione remota Windows (WinRM) devono implementare questa funzione di callback.

Il nome del punto di ingresso della DLL per questo metodo deve essere WSManPluginStartup.

Sintassi

WSMAN_PLUGIN_STARTUP WsmanPluginStartup;

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

Parametri

flags

Riservato per utilizzi futuri. Deve essere zero.

applicationIdentification

Identificatore univoco per l'applicazione ospitata. Per il servizio WinRM principale, il valore predefinito è wsman. Per un host Internet Information Services (IIS), questo identificatore è correlato all'endpoint dell'applicazione per tale host. Ad esempio, wsman/MyCompany/MyApplication.

extraInfo

Stringa che contiene informazioni di configurazione, se sono state archiviate informazioni quando è stato registrato il plug-in. Quando il plug-in viene registrato usando la configurazione WinRM, il plug-in può aggiungere parametri di configurazione aggiuntivi utili durante l'inizializzazione a un nodo facoltativo. Queste informazioni possono essere particolarmente utili se un plug-in viene usato in diversi scenari di hosting IIS e richiede una semantica di run-time leggermente diversa durante l'inizializzazione. Questa stringa è una copia del codice XML dalla configurazione, se presente. In caso contrario, questo parametro è impostato su NULL.

pluginContext

Contesto per l'inizializzazione dell'applicazione specifica. Questo contesto viene passato a tutte le altre chiamate plug-in WinRM associate a questa applicazioneIdentifier.

Valore restituito

Il metodo restituisce NO_ERROR se ha esito positivo; in caso contrario, restituisce un codice di errore. Se questo metodo restituisce un errore, il punto di ingresso WSManPluginShutdown non verrà chiamato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7
Server minimo supportato	Windows Server 2008 R2
Piattaforma di destinazione	Windows
Intestazione	wsman.h
Componente ridistribuibile	Windows Management Framework in Windows Server 2008 con SP2, Windows Vista con SP1 e Windows Vista con SP2

Condividi tramite