WSMAN_PLUGIN_SHELL コールバック関数 (wsman.h)

プラグインのシェル コールバックを定義します。 この関数は、新しいシェルの要求を受信したときに呼び出されます。 シェル操作をサポートするすべての Windows リモート管理プラグインは、このコールバックを実装する必要があります。

DLL エントリ ポイント名は WSManPluginShell である必要があります。

構文

WSMAN_PLUGIN_SHELL WsmanPluginShell;

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

パラメーター

pluginContext

WSManPluginStartup メソッドの呼び出しによって返されたコンテキストを指定します。 このパラメーターは、WinRM プラグインの特定のアプリケーション初期化を表します。

requestDetails

要求 のリソース URI、オプション、ロケール、シャットダウン フラグ、およびハンドルを指定するWSMAN_PLUGIN_REQUEST構造体へのポインター。

flags

将来利用するために予約されています。 0 に設定する必要があります。

startupInfo

シェルのスタートアップ情報を含む WSMAN_SHELL_STARTUP_INFO 構造体へのポインター。

inboundShellInformation

シェルの追加データを含むオプションの受信オブジェクトを指定する WSMAN_DATA 構造体へのポインター。

戻り値

なし

解説

WinRM (WinRM) プラグインは 、WSManPluginReportContext を呼び出してシェルのシェル コンテキストを登録します。 このシェルに対するすべての操作は、このコンテキストに渡されます。 シェルがシャットダウンされているか、プラグインが requestDetails パラメーターをチェックし、操作が取り消されたことを報告する場合、プラグインは WSManPluginOperationComplete を呼び出す必要があります。 渡されるすべてのパラメーターは、WinRM プラグインが WSManPluginOperationComplete を呼び出すまで有効です。

要件

要件	値
サポートされている最小のクライアント	Windows 7
サポートされている最小のサーバー	Windows Server 2008 R2
対象プラットフォーム	Windows
ヘッダー	wsman.h
再頒布可能パッケージ	WINDOWS Server 2008 SP2、Windows Vista sp1、Windows Vista sp2 でのWindows Management Framework