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) 的句柄。 然后,可以使用 EcGetObjectArrayPropertyEcSetObjectArrayProperty 函数获取和设置数组中的 Address、Enabled、UserName 和 Password 属性。

[in] Flags

保留。 必须为 NULL

[in] PropertyValueBufferSize

用户提供的用于存储属性值的缓冲区的大小。

[in] PropertyValueBuffer

用户提供的用于存储属性值的缓冲区。

[out] PropertyValueBufferUsed

函数成功返回时使用的用户提供的缓冲区的大小,或函数失败并 出现ERROR_INSUFFICIENT_BUFFER时存储属性值所需的大小。

返回值

此函数返回 BOOL。

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 evcoll.h
Library Wecapi.lib
DLL Wecapi.dll

另请参阅

Windows 事件收集器函数