Função EvtOpenChannelConfig (winevt.h)

Artigo
08/27/2023

Obtém um identificador que você usa para ler ou modificar a propriedade de configuração de um canal.

Sintaxe

EVT_HANDLE EvtOpenChannelConfig(
  [in] EVT_HANDLE Session,
  [in] LPCWSTR    ChannelPath,
  [in] DWORD      Flags
);

Parâmetros

[in] Session

Um identificador de sessão remota que a função EvtOpenSession retorna. Defina como NULL para acessar um canal no computador local.

[in] ChannelPath

O nome do canal a ser acessado.

[in] Flags

Reservado. Deve ser zero.

Valor retornado

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

Comentários

Para obter uma propriedade de configuração, chame a função EvtGetChannelConfigProperty .

Para modificar uma propriedade de configuração, chame a função EvtSetChannelConfigProperty . Para salvar as alterações de configuração, chame a função EvtSaveChannelConfig .

Para enumerar os canais registrados, chame a função EvtOpenChannelEnum .

Você deve chamar a função EvtClose para fechar o identificador 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


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