IESP::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 |
|---|---|
|
Die Erfassung wird angehalten und muss beendet werden, bevor sie neu gestartet werden kann. Rufen Sie IESP::Stop auf, um die Erfassung zu beenden. |
|
Die Erfassung wurde bereits gestartet. |
|
Das NPP ist nicht mit dem Netzwerk verbunden. Rufen Sie IESP::Connect auf, um das NPP mit dem Netzwerk zu verbinden. |
|
Das NPP ist mit dem Netzwerk verbunden, jedoch nicht mit der IESP::Connect-Methode . |
Bemerkungen
Der Speicherort der Erfassungsdatei wird in der Windows-Registrierung angegeben. Sie können jedoch den Netzwerkmonitor verwenden, um den Verzeichnisspeicherort zu ändern.
Wenn Sie die Erfassung mit den Methoden IESP::Start und IESP::Stop neu starten, müssen Sie die IESP::Configure-Methode aufrufen, um die Verbindung jedes Mal neu zu konfigurieren, wenn Sie IESP::Start 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 IESP::P ause und IESP::Resume starten und beenden. Wenn diese beiden Methoden verwendet werden, 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 |
|
| DLL |
|