ecGetSubscriptionProperty 函式 (evcoll.h)

EcGetSubscriptionProperty 函式會從訂用帳戶物件擷取特定的屬性值。 訂閱物件是由傳遞至 Subscription 參數的句柄所指定。

語法

BOOL EcGetSubscriptionProperty(
  [in]  EC_HANDLE                   Subscription,
  [in]  EC_SUBSCRIPTION_PROPERTY_ID PropertyId,
  [in]  DWORD                       Flags,
  [in]  DWORD                       PropertyValueBufferSize,
  [in]  PEC_VARIANT                 PropertyValueBuffer,
  [out] PDWORD                      PropertyValueBufferUsed
);

參數

[in] Subscription

訂閱物件的句柄。

[in] PropertyId

標識元，指定要取得之訂用帳戶的哪個屬性。 從 EC_SUBSCRIPTION_PROPERTY_ID 列舉指定值。 如果您指定 EcSubscriptionEventSources 值，則會傳回數位的句柄 (EC_OBJECT_ARRAY_PROPERTY_HANDLE) 。 然後，您可以使用 EcGetObjectArrayProperty 和 EcSetObjectArrayProperty 函式來取得和設定數位中的 Address、Enabled、UserName 和 Password 屬性。

[in] Flags

保留的。 必須是 NULL。

[in] PropertyValueBufferSize

要儲存屬性值的使用者提供緩衝區大小。

[in] PropertyValueBuffer

使用者提供的緩衝區，用來儲存屬性值。

[out] PropertyValueBufferUsed

函式在成功傳回時使用的使用者提供緩衝區大小，或當函式失敗且 ERROR_INSUFFICIENT_BUFFER失敗時儲存屬性值所需的大小。

傳回值

此函式會傳回 BOOL。

規格需求

另請參閱

Windows 事件收集器函式