Méthode IESP::Configure

Article
06/13/2023

La méthode Configure envoie des informations de configuration pour une 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 dans un objet BLOB d’erreur qui contient des informations d’erreur supplémentaires. Pour plus d’informations sur le contenu d’un objet BLOB d’erreur, consultez la section Remarques de cette rubrique.

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_NOT_CONNECTED	Le NPP n’est pas connecté au réseau.
NMERR_NOT_ESP	Le NPP est connecté au réseau, mais pas avec la méthode IESP::Connect .
NMERR_CAPTURING	Le NPP signale que la session de capture a démarré.
NMERR_ILLEGAL_TRIGGER	La partie déclencheur de l’objet BLOB de configuration est endommagée.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	L’objet BLOB de configuration spécifié par hConfigurationBlob ne contient pas d’entrée nécessaire pour effectuer cette opération. Examinez l’objet BLOB d’erreur retourné par hErrorBlob pour déterminer l’entrée introuvable.
NMERR_BLOB_CONVERSION_ERROR	L’objet BLOB est endommagé.
NMERR_BLOB_NOT_INITIALIZED	La méthode CreateBlob n’a pas été appelée.
NMERR_INVALID_BLOB	L’objet vers lequel est pointé n’est pas un objet BLOB.
NMERR_BLOB_STRING_INVALID	La chaîne n’est pas terminée par null.
NMERR_UPLEVEL_BLOB	Le numéro de version d’OBJET BLOB est incorrect.
NMERR_OUT_OF_MEMORY	Aucune mémoire n’était disponible. Fermez les fenêtres pour libérer des ressources.
NMERR_TIMEOUT	Le délai d'attente de la requête a expiré.

Notes

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

L’objet BLOB d’erreur retourné par le paramètre 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 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 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

Partager via