EcGetSubscriptionRunTimeStatus, fonction (evcoll.h)
La fonction EcGetSubscriptionRunTimeStatus récupère les informations d’exécution status d’une source d’événement d’un abonnement ou de l’abonnement lui-même. L’abonnement est spécifié par son nom. Si la source de l’événement est NULL, la status de l’abonnement global est récupérée.
Syntaxe
BOOL EcGetSubscriptionRunTimeStatus(
[in] LPCWSTR SubscriptionName,
[in] EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID StatusInfoId,
[in] LPCWSTR EventSourceName,
[in] DWORD Flags,
[in] DWORD StatusValueBufferSize,
[in] PEC_VARIANT StatusValueBuffer,
[out] PDWORD StatusValueBufferUsed
);
Paramètres
[in] SubscriptionName
Nom de l’abonnement à partir duquel obtenir l’heure d’exécution status informations.
[in] StatusInfoId
Identificateur qui spécifie l’heure d’exécution status informations à obtenir à partir de l’abonnement. Spécifiez une valeur de l’énumération EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID . La valeur EcSubscriptionRunTimeStatusEventSources peut être utilisée pour obtenir la liste des sources d’événements associées à un abonnement.
[in] EventSourceName
Nom de la source d’événement à partir de laquelle obtenir le status. Chaque abonnement peut avoir plusieurs sources d’événements.
[in] Flags
Réservé. Doit être NULL.
[in] StatusValueBufferSize
Taille de la mémoire tampon fournie par l’utilisateur qui contiendra l’heure d’exécution status informations.
[in] StatusValueBuffer
Mémoire tampon fournie par l’utilisateur qui contiendra les informations d’exécution status. La mémoire tampon contiendra la valeur appropriée en fonction de la valeur EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID passée dans le paramètre StatusInfoId .
[out] StatusValueBufferUsed
Taille de la mémoire tampon fournie par l’utilisateur utilisée par la fonction lors d’un retour réussi, ou taille nécessaire pour stocker la valeur de propriété en cas d’échec de la fonction avec ERROR_INSUFFICIENT_BUFFER.
Valeur retournée
Cette fonction retourne BOOL.
Spécifications
| 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 |