MI_Application_NewSession関数 (mi.h)
一連の操作の接続を 1 つの宛先に共有するために使用されるセッションを作成します。
構文
MI_INLINE MI_Result MI_Application_NewSession(
[in] MI_Application *application,
[in, optional] const MI_Char *protocol,
[in, optional] const MI_Char *destination,
[in, optional] MI_DestinationOptions *options,
[in, optional] MI_SessionCallbacks *callbacks,
MI_Instance **extendedError,
[out] MI_Session *session
);
パラメーター
[in] application
MI_Application_Initialize関数から返されるハンドルへのポインター。
[in, optional] protocol
操作を実行するためのオプションのプロトコル ハンドラーへのポインター。 このパラメーターが NULL の場合は、宛先に基づいて既定値が使用されます。 現在サポートされているプロトコルは、L"WMIDCOM" と L"WINRM" です。
[in, optional] destination
セッションのオプションの宛先。 destination 引数が NULL の場合、セッションはローカル コンピューターと通信します。 それ以外の場合、宛先にはローカル コンピューターまたはリモート コンピューターのコンピューター名を指定できます。
[in, optional] options
既定のタイムアウトや資格情報など、オプションの宛先オプションへのポインター。
[in, optional] callbacks
さまざまな結果を受け取るコールバックを含む省略可能なMI_SessionCallbacks構造体へのポインター。
extendedError
操作が失敗した場合のオプションの追加エラー情報へのポインター。 エラー情報の使用が完了したら、 MI_Instance_Delete 関数を呼び出してメモリを解放します。
[out] session
返されたセッション ハンドルへのポインター。 セッション ハンドルの使用が完了したら、 MI_Session_Close 関数を呼び出して閉じます。 アプリケーションとアプリケーション ハンドルの両方をシャットダウンする前にセッション ハンドルが閉じていない場合、アプリケーション ハンドルのシャットダウンは応答しません。
戻り値
この関数は、MI_INLINE MI_Resultを返します。
注釈
宛先を作成すると、ターゲット コンピューターと通信できない場合があります。 最初の操作がセッションで実行されるまで、アプリケーションはコンピューターにアクセスできるかどうかを判断できます。
MI_Session_Close関数は、送信セッション ハンドルで呼び出す必要があります。 セッションを閉じる前に、ターゲット セッションのすべての操作を閉じます。
プロトコルが指定されておらず、 宛先 が NULL の場合は、WMIDCOM プロトコルが使用されます。 プロトコルが指定されておらず、 宛先 が NULL でない場合は、WINRM プロトコルが使用されます。 .
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 |
| サポートされている最小のサーバー | Windows Server 2012 |
| 対象プラットフォーム | Windows |
| ヘッダー | mi.h |
| 再頒布可能パッケージ | windows Server 2008 R2 sp1、Windows 7 SP1、Windows Server 2008 SP2 で 3.0 をWindows Management Frameworkする |