EcOpenSubscription-Funktion (evcoll.h)
Die EcOpenSubscription-Funktion wird verwendet, um ein vorhandenes Abonnement zu öffnen oder ein neues Abonnement gemäß dem angegebenen Flagwert zu erstellen.
Syntax
EC_HANDLE EcOpenSubscription(
[in] LPCWSTR SubscriptionName,
[in] DWORD AccessMask,
[in] DWORD Flags
);
Parameter
[in] SubscriptionName
Gibt den Namen des Abonnements an. Der für diesen Parameter bereitgestellte Wert sollte innerhalb des Bereichs des Computers eindeutig sein.
[in] AccessMask
Eine Zugriffsmaske, die die gewünschten Zugriffsrechte für das Abonnement angibt. Verwenden Sie die EC_READ_ACCESS oderEC_WRITE_ACCESS Konstanten, um die Zugriffsrechte anzugeben. Die Funktion schlägt fehl, wenn der Sicherheitsdeskriptor des Abonnements den angeforderten Zugriff für den aufrufenden Prozess nicht zulässt.
[in] Flags
Ein -Wert, der angibt, ob ein neues oder ein vorhandenes Abonnement geöffnet wird. Verwenden Sie die konstanten EC_CREATE_NEW, EC_OPEN_ALWAYS oder EC_OPEN_EXISTING .
Rückgabewert
Wenn die Funktion erfolgreich ist, wird ein Handle (EC_HANDLE) an ein neues Abonnementobjekt zurückgegeben. Gibt andernfalls NULL zurück, in diesem Fall verwenden Sie die GetLastError-Funktion , um den Fehlercode abzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | evcoll.h |
| Bibliothek | Wecapi.lib |
| DLL | Wecapi.dll |