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 函式來取得錯誤碼。