Partager via


IESP::Start, méthode

La méthode Start démarre une capture.

Syntaxe

HRESULT STDMETHODCALLTYPE Start(
  [out] char *pFileName
);

Paramètres

pFileName [out]

Pointeur vers le nom du fichier de capture utilisé pour stocker les données réseau. Veillez à mettre en cache ce nom de fichier s’il est nécessaire pour référence ultérieure.

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_CAPTURE_PAUSED
La capture est suspendue et doit être arrêtée avant de pouvoir être redémarrée. Appelez IESP::Stop pour arrêter la capture.
NMERR_CAPTURING
La capture est déjà démarrée.
NMERR_NOT_CONNECTED
Le NPP n’est pas connecté au réseau. Appelez IESP::Connect pour connecter le NPP au réseau.
NMERR_NOT_ESP
Le NPP est connecté au réseau, mais pas avec la méthode IESP::Connect .

Notes

L’emplacement du fichier de capture est spécifié dans le Registre Windows, mais vous pouvez utiliser le Moniteur réseau pour modifier l’emplacement du répertoire.

Lorsque vous redémarrez la capture à l’aide des méthodes IESP::Start et IESP::Stop , vous devez appeler la méthode IESP::Configure pour reconfigurer la connexion chaque fois que vous appelez IESP::Start pour redémarrer la capture des données. Lorsque vous démarrez et arrêtez la capture avec ces trois méthodes, un nouveau fichier de capture est créé chaque fois que la capture est démarrée.

Notes

Vous pouvez également démarrer et arrêter la capture à l’aide des méthodes IESP::P ause et IESP::Resume . Lorsque ces deux méthodes sont utilisées, les données capturées sont stockées dans le même fichier de capture.

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

IESP

IESP::Configure

IESP::Connect

IESP::P ause

IESP::Resume

IESP::Stop