Função EvtSetChannelConfigProperty (winevt.h)

Define a propriedade de configuração especificada de um canal.

Sintaxe

BOOL EvtSetChannelConfigProperty(
  [in] EVT_HANDLE                     ChannelConfig,
  [in] EVT_CHANNEL_CONFIG_PROPERTY_ID PropertyId,
  [in] DWORD                          Flags,
  [in] PEVT_VARIANT                   PropertyValue
);

Parâmetros

[in] ChannelConfig

Um identificador para as propriedades de configuração do canal que a função EvtOpenChannelConfig retorna.

[in] PropertyId

O identificador da propriedade de canal a ser definida. Para obter uma lista de identificadores de propriedade, consulte a enumeração EVT_CHANNEL_CONFIG_PROPERTY_ID .

[in] Flags

Reservado. Deve ser zero.

[in] PropertyValue

O valor da propriedade a ser definido.

Um buffer alocado pelo chamador que contém o novo valor da propriedade de configuração. O buffer contém um objeto EVT_VARIANT . Defina o valor de configuração e o tipo de variante.

Retornar valor

Valor/código retornado Descrição
TRUE
A função foi bem-sucedida.
FALSE
A função falhou. Para obter o código de erro, chame a função GetLastError .

Comentários

Essa função altera uma cópia na memória das propriedades de configuração. Para aplicar as alterações feitas a uma ou mais das propriedades de configuração, chame a função EvtSaveChannelConfig .

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

EvtGetChannelConfigProperty

EvtOpenChannelConfig

EvtSaveChannelConfig