EcOpenSubscription 함수(evcoll.h)

EcOpenSubscription 함수는 기존 구독을 열거나 지정된 플래그 값에 따라 새 구독을 만드는 데 사용됩니다.

구문

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

[in] SubscriptionName

구독의 이름을 지정합니다. 이 매개 변수에 제공된 값은 컴퓨터의 scope 내에서 고유해야 합니다.

[in] AccessMask

구독에 대한 원하는 액세스 권한을 지정하는 액세스 마스크입니다. EC_READ_ACCESS 또는 EC_WRITE_ACCESS 상수를 사용하여 액세스 권한을 지정합니다. 구독의 보안 설명자가 호출 프로세스에 대해 요청된 액세스를 허용하지 않으면 함수가 실패합니다.

[in] Flags

새 구독 또는 기존 구독을 열지 여부를 지정하는 값입니다. EC_CREATE_NEW, EC_OPEN_ALWAYS 또는 EC_OPEN_EXISTING 상수를 사용합니다.

함수가 성공하면 핸들(EC_HANDLE)을 새 구독 개체에 반환합니다. 그렇지 않으면 NULL 을 반환합니다. 이 경우 GetLastError 함수를 사용하여 오류 코드를 가져옵니다.