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 |