Função EvtOpenChannelConfig (winevt.h)
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 |