Função EcGetSubscriptionRunTimeStatus (evcoll.h)

Artigo
08/23/2023

A função EcGetSubscriptionRunTimeStatus recupera o tempo de execução status informações para uma origem de evento de uma assinatura ou a própria assinatura. A assinatura é especificada por seu nome. Se a origem do evento for NULL, o status da assinatura geral será recuperado.

Sintaxe

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

O nome da assinatura da qual obter o tempo de execução status informações.

[in] StatusInfoId

Um identificador que especifica qual tempo de execução status informações a serem obtidos da assinatura. Especifique um valor da enumeração EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID . O valor EcSubscriptionRunTimeStatusEventSources pode ser usado para obter a lista de fontes de eventos associadas a uma assinatura.

[in] EventSourceName

O nome da origem do evento do qual obter o status. Cada assinatura pode ter várias fontes de eventos.

[in] Flags

Reservado. Deve ser NULL.

[in] StatusValueBufferSize

O tamanho do buffer fornecido pelo usuário que conterá o tempo de execução status informações.

[in] StatusValueBuffer

O buffer fornecido pelo usuário que conterá o tempo de execução status informações. O buffer conterá o valor apropriado dependendo do valor de EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID passado para o parâmetro StatusInfoId .

[out] StatusValueBufferUsed

O tamanho do buffer fornecido pelo usuário usado pela função no retorno bem-sucedido ou o tamanho necessário para armazenar o valor da propriedade quando a função falhar com ERROR_INSUFFICIENT_BUFFER.

Valor retornado

Essa função retorna BOOL.

Requisitos


Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	evcoll.h
Biblioteca	Wecapi.lib
DLL	Wecapi.dll

Confira também

Funções do Coletor de Eventos do Windows

Compartilhar via