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 事件收集器函式