EcGetSubscriptionRunTimeStatus-Funktion (evcoll.h)
Die EcGetSubscriptionRunTimeStatus-Funktion ruft die Laufzeit status Informationen für eine Ereignisquelle eines Abonnements oder des Abonnements selbst ab. Das Abonnement wird durch seinen Namen angegeben. Wenn die Ereignisquelle NULL ist, wird der status für das gesamte Abonnement abgerufen.
Syntax
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
);
Parameter
[in] SubscriptionName
Der Name des Abonnements, aus dem die Laufzeit status Informationen abgerufen werden soll.
[in] StatusInfoId
Ein Bezeichner, der angibt, welche Laufzeit status Informationen aus dem Abonnement abrufen soll. Geben Sie einen Wert aus der EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID-Enumeration an. Der Wert EcSubscriptionRunTimeStatusEventSources kann verwendet werden, um die Liste der Ereignisquellen abzurufen, die einem Abonnement zugeordnet sind.
[in] EventSourceName
Der Name der Ereignisquelle, aus der die status abgerufen werden soll. Jedes Abonnement kann über mehrere Ereignisquellen verfügen.
[in] Flags
Reserviert. Muss NULL sein.
[in] StatusValueBufferSize
Die Größe des vom Benutzer bereitgestellten Puffers, der die Laufzeit status Informationen enthält.
[in] StatusValueBuffer
Der vom Benutzer bereitgestellte Puffer, der die Laufzeit status Informationen enthält. Der Puffer enthält den entsprechenden Wert, abhängig vom EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID Wert, der an den StatusInfoId-Parameter übergeben wird.
[out] StatusValueBufferUsed
Die Größe des vom Benutzer bereitgestellten Puffers, der von der Funktion bei erfolgreicher Rückgabe verwendet wird, oder die Größe, die erforderlich ist, um den Eigenschaftswert zu speichern, wenn die Funktion mit ERROR_INSUFFICIENT_BUFFER fehlschlägt.
Rückgabewert
Diese Funktion gibt BOOL zurück.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | evcoll.h |
| Bibliothek | Wecapi.lib |
| DLL | Wecapi.dll |