Share via

EcGetSubscriptionRunTimeStatus-Funktion (evcoll.h)

  • Artikel

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

Weitere Informationen

Windows-Ereignissammlerfunktionen