IStats::Configure, méthode

  • Article
  • 2 minutes de lecture

La méthode Configure envoie des informations de configuration de capture.

Syntaxe

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

Paramètres

hConfigurationBlob [in]

Gérez l’objet BLOB configuré par l’appelant.

hErrorBlob [out]

Gérez un objet BLOB d’erreurs qui contient des informations 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_STRING_INVALID
 La chaîne n’est pas terminée par null.
NMERR_BLOB_NOT_INITIALIZED
 La méthode CreateBlob n’a pas été appelée.
NMERR_INVALID_BLOB
 L’objet pointé n’est pas un OBJET BLOB.
NMERR_UPLEVEL_BLOB
 Le numéro de version d’objet BLOB est incorrect.
NMERR_BLOB_ENTRY_ALREADY_EXISTS
 Une entrée BLOB existe déjà.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
 L’objet BLOB de configuration spécifié par le paramètre hConfigurationBlob n’a pas d’entrée nécessaire pour effectuer cette opération. Examinez l’objet BLOB d’erreur retourné par le paramètre hErrorBlob pour déterminer quelle entrée n’a pas été trouvée.
NMERR_AMBIGUOUS_SPECIFIER
 L’objet BLOB n’a pas d’informations de propriétaire ou de catégorie.
NMERR_BLOB_OWNER_NOT_FOUND
 La section Propriétaire de l’objet BLOB n’a pas été trouvée.
NMERR_BLOB_CATEGORY_NOT_FOUND
 La section Catégorie de l’objet BLOB n’a pas été trouvée.
NMERR_UNKNOWN_CATEGORY
 Les informations de catégorie ont été trouvées, mais elles n’ont pas été comprises.
NMERR_UNKNOWN_TAG
 Les informations de balise ont été trouvées, mais elles n’ont pas été comprises.
NMERR_BLOB_CONVERSION_ERROR
 L’objet BLOB est endommagé.
NMERR_ILLEGAL_TRIGGER
 La partie déclencheur de l’objet BLOB est endommagée.

Remarques

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

L’objet BLOB d’erreur retourné par hErrorBlob contient des entrées que Network Monitor n’a pas pu comprendre ou trouver dans l’objet BLOB de configuration spécifié dans le paramètre hConfigurationBlob . L’objet BLOB d’erreur retourné contient des informations 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 Du moniteur réseau n’a pas pu trouver 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

IStats

ISTATS::Connecter

OBJETS BLOB du Moniteur réseau