Compartilhar via


Função EvtOpenChannelEnum (winevt.h)

Obtém um identificador que você usa para enumerar a lista de canais registrados no computador.

Sintaxe

EVT_HANDLE EvtOpenChannelEnum(
  [in] EVT_HANDLE Session,
  [in] DWORD      Flags
);

Parâmetros

[in] Session

Um identificador de sessão remota que a função EvtOpenSession retorna. Defina como NULL para enumerar os canais no computador local.

[in] Flags

Reservado. Deve ser zero.

Retornar valor

Se tiver êxito, a função retornará um identificador para a lista de nomes de canal registrados no computador; caso contrário, NULL. Se FOR NULL, chame a função GetLastError para obter o código de erro.

Comentários

A enumeração inclui todos os canais que os provedores registrados no computador definiram. Para enumerar os nomes de canal, chame a função EvtNextChannelPath em um loop. Os nomes são classificados em ordem alfabética.

Você deve chamar a função EvtClose para fechar o identificador de enumerador quando terminar.

Exemplos

Para obter um exemplo que mostra como usar essa função, consulte Obtendo e definindo as propriedades de configuração de um canal.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winevt.h
Biblioteca Wevtapi.lib
DLL Wevtapi.dll

Confira também

EvtNextChannelPath

EvtOpenChannelConfig