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 |
---|---|
|
A função foi bem-sucedida. |
|
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 |