ecOpenSubscription 函数 (evcoll.h)

EcOpenSubscription 函数用于根据指定的标志值打开现有订阅或创建新订阅。

语法

EC_HANDLE EcOpenSubscription(
  [in] LPCWSTR SubscriptionName,
  [in] DWORD   AccessMask,
  [in] DWORD   Flags
);

[in] SubscriptionName

指定订阅的名称。为此参数提供的值在计算机范围内应是唯一的。

[in] AccessMask

一个访问掩码，指定对订阅的所需访问权限。使用 EC_READ_ACCESS 或 EC_WRITE_ACCESS 常量指定访问权限。如果订阅的安全描述符不允许对调用进程进行请求的访问，则函数将失败。

[in] Flags

一个值，该值指定是要打开新的订阅还是打开现有订阅。使用 EC_CREATE_NEW、 EC_OPEN_ALWAYS或 EC_OPEN_EXISTING 常量。

如果该函数成功，它将返回一个句柄， (EC_HANDLE) 到新的订阅对象。否则返回 NULL ，在这种情况下，使用 GetLastError 函数获取错误代码。