Fungsi EcOpenSubscription (evcoll.h)

Fungsi EcOpenSubscription digunakan untuk membuka langganan yang sudah ada atau membuat langganan baru sesuai dengan nilai bendera yang ditentukan.

Sintaks

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

Parameter

[in] SubscriptionName

Menentukan nama langganan. Nilai yang disediakan untuk parameter ini harus unik dalam cakupan komputer.

[in] AccessMask

Masker akses yang menentukan hak akses yang diinginkan ke langganan. Gunakan konstanta EC_READ_ACCESS atau EC_WRITE_ACCESS untuk menentukan hak akses. Fungsi gagal jika pendeskripsi keamanan langganan tidak mengizinkan akses yang diminta untuk proses panggilan.

[in] Flags

Nilai yang menentukan apakah langganan baru atau yang sudah ada akan dibuka. Gunakan konstanta EC_CREATE_NEW, EC_OPEN_ALWAYS, atau EC_OPEN_EXISTING .

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan handel (EC_HANDLE) ke objek langganan baru. Mengembalikan NULL jika tidak, dalam hal ini gunakan fungsi GetLastError untuk mendapatkan kode kesalahan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	evcoll.h
Pustaka	Wecapi.lib
DLL	Wecapi.dll

Lihat juga

Fungsi Pengumpul Peristiwa Windows