Funzione EcGetSubscriptionRunTimeStatus (evcoll.h)

La funzione EcGetSubscriptionRunTimeStatus recupera le informazioni sullo stato di runtime per un'origine evento di una sottoscrizione o della sottoscrizione stessa. La sottoscrizione viene specificata dal nome. Se l'origine evento è NULL, viene recuperato lo stato della sottoscrizione complessiva.

Sintassi

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
);

Parametri

[in] SubscriptionName

Nome della sottoscrizione da cui ottenere le informazioni sullo stato di runtime.

[in] StatusInfoId

Identificatore che specifica le informazioni sullo stato di runtime da ottenere dalla sottoscrizione. Specificare un valore dall'enumerazione EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID . Il valore EcSubscriptionRunTimeStatusEventSources può essere usato per ottenere l'elenco delle origini evento associate a una sottoscrizione.

[in] EventSourceName

Nome dell'origine evento da cui ottenere lo stato. Ogni sottoscrizione può avere più origini eventi.

[in] Flags

Riservato. Deve essere NULL.

[in] StatusValueBufferSize

Dimensioni del buffer fornito dall'utente che conterrà le informazioni sullo stato di runtime.

[in] StatusValueBuffer

Buffer fornito dall'utente che conterrà le informazioni sullo stato di runtime. Il buffer conterrà il valore appropriato a seconda del valore EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID passato nel parametro StatusInfoId .

[out] StatusValueBufferUsed

Dimensione del buffer fornito dall'utente utilizzata dalla funzione in caso di restituzione riuscita oppure la dimensione necessaria per archiviare il valore della proprietà quando la funzione ha esito negativo con ERROR_INSUFFICIENT_BUFFER.

Valore restituito

Questa funzione restituisce BOOL.

Requisiti

Vedi anche

Funzioni dell'agente di raccolta eventi di Windows