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

Weitere Informationen

Windows-Ereignissammlerfunktionen