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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | evcoll.h |
| Bibliothèque | Wecapi.lib |
| DLL | Wecapi.dll |