Función EcGetSubscriptionRunTimeStatus (evcoll.h)

La función EcGetSubscriptionRunTimeStatus recupera la información de estado en tiempo de ejecución de un origen de evento de una suscripción o de la propia suscripción. La suscripción se especifica por su nombre. Si el origen del evento es NULL, se recupera el estado de la suscripción general.

Sintaxis

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

Parámetros

[in] SubscriptionName

Nombre de la suscripción de la que se va a obtener la información de estado en tiempo de ejecución.

[in] StatusInfoId

Identificador que especifica la información de estado en tiempo de ejecución que se va a obtener de la suscripción. Especifique un valor de la enumeración EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID . El valor EcSubscriptionRunTimeStatusEventSources se puede usar para obtener la lista de orígenes de eventos asociados a una suscripción.

[in] EventSourceName

Nombre del origen del evento del que se va a obtener el estado. Cada suscripción puede tener varios orígenes de eventos.

[in] Flags

Reservado. Debe ser NULL.

[in] StatusValueBufferSize

Tamaño del búfer proporcionado por el usuario que contendrá la información de estado en tiempo de ejecución.

[in] StatusValueBuffer

Búfer proporcionado por el usuario que contendrá la información de estado del tiempo de ejecución. El búfer contendrá el valor adecuado en función del valor de EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID pasado al parámetro StatusInfoId .

[out] StatusValueBufferUsed

Tamaño del búfer proporcionado por el usuario que usa la función en la devolución correcta, o el tamaño necesario para almacenar el valor de propiedad cuando se produce un error en la función ERROR_INSUFFICIENT_BUFFER.

Valor devuelto

Esta función devuelve BOOL.

Requisitos

Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	evcoll.h
Library	Wecapi.lib
Archivo DLL	Wecapi.dll

Consulte también

Funciones del recopilador de eventos de Windows