IRTC::Configure, méthode

Article
06/13/2023

La méthode Configure envoie des données de configuration pour une capture de données.

Syntaxe

HRESULT STDMETHODCALLTYPE Configure(
  [in]  HBLOB hConfigurationBlob,
  [out] HBLOB hErrorBlob
);

Paramètres

hConfigurationBlob [in]: Handle pour l’objet BLOB configuré par l’appelant.
hErrorBlob [out]: Handle d’un objet BLOB d’erreur qui contient des données d’erreur supplémentaires.

Valeur retournée

Si la méthode réussit, la valeur de retour est NMERR_SUCCESS.

Si la méthode échoue, la valeur de retour est l’un des codes d’erreur suivants :

Code de retour	Description
NMERR_BLOB_NOT_INITIALIZED	La méthode CreateBlob n’a pas été appelée.
NMERR_INVALID_BLOB	L’objet pointé vers n’est pas un objet BLOB.
NMERR_UPLEVEL_BLOB	Le numéro de version de BLOB est incorrect.
NMERR_BLOB_ENTRY_ALREADY_EXISTS	Blob en double.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	L’objet BLOB de configuration spécifié par hConfigurationBlob n’a pas d’entrée nécessaire pour effectuer cette opération. Affichez l’objet BLOB d’erreur retourné par hErrorBlob pour déterminer l’entrée introuvable.
NMERR_AMBIGUOUS_SPECIFIER	Les données propriétaire ou catégorie d’objet BLOB sont manquantes.
NMERR_BLOB_OWNER_NOT_FOUND	La section Propriétaire de l’objet BLOB est introuvable.
NMERR_BLOB_CATEGORY_NOT_FOUND	La section Catégorie d’objets blob est introuvable.
NMERR_UNKNOWN_CATEGORY	La section Catégorie d’objets blob a été trouvée, mais elle n’a pas été comprise.
NMERR_UNKNOWN_TAG	La section Balise BLOB a été trouvée, mais elle n’a pas été comprise.
NMERR_BLOB_CONVERSION_ERROR	L’objet BLOB est endommagé.
NMERR_ILLEGAL_TRIGGER	La partie déclencheur de l’objet BLOB est endommagée.
NMERR_BLOB_STRING_INVALID	La chaîne n’est pas terminée par null.

Notes

Vous devez appliquer cette méthode pour redémarrer un NPP qui a été démarré, arrêté, mais non déconnecté.

L’objet BLOB d’erreur retourné par hErrorBlob contient des entrées que le Moniteur réseau n’a pas pu comprendre ou trouver dans l’objet BLOB de configuration spécifié dans hConfigurationBlob. L’objet BLOB d’erreur retourné contient des données d’erreur que l’application peut utiliser pour la résolution des problèmes. Par exemple, si NMERR_BLOB_ENTRY_DOES_NOT_EXIST est retourné, l’entrée Moniteur réseau introuvable est incluse dans l’objet BLOB d’erreur retourné.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Netmon.h
DLL	Ndisnpp.dll; Rmtnpp.dll

Voir aussi

IRTC
IRTC::Connect
OBJETS BLOB du moniteur réseau

Partager via