EcOpenSubscription, fonction (evcoll.h)

La fonction EcOpenSubscription permet d’ouvrir un abonnement existant ou de créer un abonnement en fonction de la valeur d’indicateur spécifiée.

Syntaxe

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

Paramètres

[in] SubscriptionName

Spécifie le nom de l'abonnement. La valeur fournie pour ce paramètre doit être unique dans l’étendue de l’ordinateur.

[in] AccessMask

Masque d’accès qui spécifie les droits d’accès souhaités à l’abonnement. Utilisez les constantes EC_READ_ACCESS ou EC_WRITE_ACCESS pour spécifier les droits d’accès. La fonction échoue si le descripteur de sécurité de l’abonnement n’autorise pas l’accès demandé pour le processus d’appel.

[in] Flags

Valeur spécifiant si un abonnement nouveau ou existant sera ouvert. Utilisez les constantes EC_CREATE_NEW, EC_OPEN_ALWAYS ou EC_OPEN_EXISTING .

Valeur retournée

Si la fonction réussit, elle retourne un handle (EC_HANDLE) à un nouvel objet d’abonnement. Retourne la valeur NULL dans le cas contraire, auquel cas utilisez la fonction GetLastError pour obtenir le code d’erreur.

Configuration requise

Voir aussi

Fonctions du collecteur d’événements Windows