藉由與會話所代表的伺服器通訊來測試連線,以判斷其是否回應。
語法
MI_INLINE void MI_Session_TestConnection(
[in] MI_Session *session,
MI_Uint32 flags,
[in, optional] MI_OperationCallbacks *callbacks,
[out] MI_Operation *operation
);
參數
[in] session
從 MI_Application_NewSession 傳回的會話句柄。
flags
必須是 0。
[in, optional] callbacks
選擇性 MI_OperationCallbacks 結構,定義接收實例結果和 CIM 語意的操作回呼。 若要以異步方式執行作業,必須指定結構的 instanceResult 回呼成員。 如果未指定此成員,客戶端必須呼叫 MI_Operation_GetInstance 函式來擷取結果。
[out] operation
傳回的作業句柄,必須在完成之後,透過 MI_Operation_Close 關閉 。 在完成之前 呼叫MI_Operation_Cancel 會導致作業關閉。 您可以從任何作業呼叫MI_Operation_Close和MI_Operation_Cancel。
傳回值
無
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 最低支援的伺服器 | Windows Server 2012 |
| 目標平台 | Windows |
| 標頭 | mi.h |
| 可轉散發套件 | Windows Management Framework Windows Server 2008 R2 SP1、Windows 7 SP1 和 Windows Server 2008 SP2 上的 3.0 |