Fonction EventSetInformation (evntprov.h)

Configure un fournisseur d’événements ETW.

Syntaxe

ULONG EVNTAPI EventSetInformation(
  [in] REGHANDLE        RegHandle,
  [in] EVENT_INFO_CLASS InformationClass,
  [in] PVOID            EventInformation,
  [in] ULONG            InformationLength
);

Paramètres

[in] RegHandle

Handle d’inscription du fournisseur d’événements. Il s’agit d’un handle retourné par EventRegister.

[in] InformationClass

EVENT_INFO_CLASS valeur qui spécifie l’opération de configuration à effectuer sur le fournisseur d’événements.

[in] EventInformation

Pointeur vers une mémoire tampon qui contient des données à utiliser lors de la configuration du fournisseur d’événements. Le format des données de cette mémoire tampon dépend de la valeur spécifiée dans le paramètre InformationClass .

Cette valeur peut être NULL si InformationLength est égal à zéro.

[in] InformationLength

Taille (en octets) des données dans la mémoire tampon EventInformation .

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

• ERROR_INVALID_PARAMETER : le paramètre est incorrect. Par exemple, cette erreur est retournée si le paramètre RegHandle n’est pas un handle d’inscription de fournisseur valide, si EventInformation a la valeur NULL , mais InformationLength n’est pas nul ou si le paramètre InformationLength spécifié n’est pas valide pour l’InformationClasse donnée.
• ERROR_NOT_SUPPORTED : la demande n’est pas prise en charge. Cette erreur est retournée si le paramètre InformationClass n’est pas une valeur reconnue.
• Autre : utilisez FormatMessage pour obtenir la chaîne de message pour l’erreur retournée.

Spécifications

Voir aussi

EVENT_INFO_CLASS

EventRegister