Freigeben über


IDelaydC::Start-Methode

Die Start-Methode startet eine Erfassung.

Syntax

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

Parameter

pFileName [out]

Zeiger auf den Namen der Erfassungsdatei , die zum Speichern der Netzwerkdaten verwendet wird. Stellen Sie sicher, dass Sie diesen Dateinamen zwischenspeichern, wenn er für einen späteren Verweis benötigt wird.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert NMERR_SUCCESS.

Wenn die Methode nicht erfolgreich ist, ist der Rückgabewert einer der folgenden Fehlercodes:

Rückgabecode Beschreibung
NMERR_CAPTURE_PAUSED
Die Erfassung befindet sich in einem angehaltenen Zustand und muss beendet werden, bevor sie neu gestartet werden kann. Rufen Sie IDelaydC::Stop auf, um die Erfassung zu beenden. Weitere Informationen finden Sie im Abschnitt Hinweise in diesem Thema.
NMERR_CAPTURING
Die Erfassung wurde bereits gestartet.
NMERR_NOT_CONNECTED
Das NPP ist nicht mit dem Netzwerk verbunden. Rufen Sie IDelaydC::Connect auf, um eine Verbindung mit dem Netzwerk herzustellen.
NMERR_NOT_DELAYED
Das NPP ist mit dem Netzwerk verbunden, jedoch nicht mit der IDelaydC::Connect-Methode .

Bemerkungen

Der Speicherort der Erfassungsdatei wird in Ihrer Windows-Registrierung angegeben. Sie können jedoch den Netzwerkmonitor verwenden, um den Speicherort der Datei zu ändern.

Um die Erfassung mithilfe von IDelaydC::Start und IDelaydC::Stop neu zu starten, müssen Sie die IDelaydC::Configure-Methode aufrufen, um die Verbindung jedes Mal neu zu konfigurieren, wenn Sie die IDelaydC::Start-Methode aufrufen, um die Erfassung von Daten neu zu starten. Wenn Sie die Erfassung mit diesen drei Methoden starten und beenden, wird bei jedem Start der Erfassung eine neue Erfassungsdatei erstellt.

Hinweis

Sie können die Erfassung auch mit den Methoden IDelaydC::P ause und IDelaydC::Resume starten und beenden. Wenn Sie diese beiden Methoden verwenden, werden die erfassten Daten in derselben Erfassungsdatei gespeichert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Netmon.h
DLL
Ndisnpp.dll;
Rmtnpp.dll

Weitere Informationen

IDelaydC

IDelaydC::Configure

IDelaydC::Connect

IDelaydC::P ause

IDelaydC::Resume

IDelaydC::Stop