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 関数を使用してエラー コードを取得します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | evcoll.h |
| Library | Wecapi.lib |
| [DLL] | Wecapi.dll |