ecGetSubscriptionRunTimeStatus 函式 (evcoll.h)
EcGetSubscriptionRunTimeStatus函式會擷取訂閱或訂閱本身事件來源的執行時間狀態資訊。 訂用帳戶的名稱會指定。 如果事件來源為 Null,則會擷取整體訂用帳戶的狀態。
語法
BOOL EcGetSubscriptionRunTimeStatus(
[in] LPCWSTR SubscriptionName,
[in] EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID StatusInfoId,
[in] LPCWSTR EventSourceName,
[in] DWORD Flags,
[in] DWORD StatusValueBufferSize,
[in] PEC_VARIANT StatusValueBuffer,
[out] PDWORD StatusValueBufferUsed
);
參數
[in] SubscriptionName
要從中取得執行時間狀態資訊的訂用帳戶名稱。
[in] StatusInfoId
識別碼,指定要從訂用帳戶取得的執行時間狀態資訊。 從 EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID 列舉指定值。 EcSubscriptionRunTimeStatusEventSources值可用來取得與訂用帳戶相關聯的事件來源清單。
[in] EventSourceName
要從中取得狀態的事件來源名稱。 每個訂用帳戶可以有多個事件來源。
[in] Flags
保留的。 必須是 Null。
[in] StatusValueBufferSize
將保存執行時間狀態資訊的使用者提供緩衝區大小。
[in] StatusValueBuffer
使用者提供的緩衝區,其會保存執行時間狀態資訊。 緩衝區會根據傳遞至StatusInfoId參數的EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID值來保留適當的值。
[out] StatusValueBufferUsed
在成功傳回時,函式所使用的使用者提供緩衝區大小,或當函式失敗且 ERROR_INSUFFICIENT_BUFFER失敗時儲存屬性值所需的大小。
傳回值
此函式會傳回 BOOL。
需求
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | evcoll.h |
程式庫 | Wecapi.lib |
Dll | Wecapi.dll |