WSMAN_PLUGIN_SHELL funzione di callback (wsman.h)

Articolo
03/04/2024

Definisce il callback della shell per un plug-in. Questa funzione viene chiamata quando viene ricevuta una richiesta per una nuova shell. Tutti i plug-in di Gestione remota Windows che supportano le operazioni della shell devono implementare questo callback.

Il nome del punto di ingresso della DLL deve essere WSManPluginShell.

Sintassi

WSMAN_PLUGIN_SHELL WsmanPluginShell;

void WsmanPluginShell(
  PVOID pluginContext,
  WSMAN_PLUGIN_REQUEST *requestDetails,
  DWORD flags,
  WSMAN_SHELL_STARTUP_INFO *startupInfo,
  WSMAN_DATA *inboundShellInformation
)
{...}

Parametri

pluginContext

Specifica il contesto restituito da una chiamata al metodo WSManPluginStartup . Questo parametro rappresenta un'inizializzazione specifica dell'applicazione di un plug-in WinRM.

requestDetails

Puntatore a una struttura WSMAN_PLUGIN_REQUEST che specifica l'URI, le opzioni, le impostazioni locali, il flag di arresto e l'handle per la richiesta.

flags

Riservato per utilizzi futuri. Deve essere impostato su zero.

startupInfo

Puntatore a una struttura WSMAN_SHELL_STARTUP_INFO che contiene informazioni di avvio per la shell.

inboundShellInformation

Puntatore a una struttura WSMAN_DATA che specifica un oggetto in ingresso facoltativo che contiene dati aggiuntivi per la shell.

Valore restituito

nessuno

Osservazioni

Il plug-in WinRM (WinRM) chiama WSManPluginReportContext per registrare un contesto della shell per la shell. Tutte le operazioni su questa shell passano in questo contesto. Se la shell ha arrestato o il plug-in controlla il parametro requestDetails e segnala che l'operazione è stata annullata, il plug-in deve chiamare WSManPluginOperationComplete. Tutti i parametri passati sono validi fino a quando il plug-in WinRM chiama WSManPluginOperationComplete.

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