GetCaptureCommentFromFilename-Funktion

Die GetCaptureCommentFromFilename-Funktion extrahiert den Aufzeichnungskommentar aus einer Aufzeichnungsdatei.

Syntax

DWORD  WINAPI GetCaptureCommentFromFilename(
  _In_ LPSTR lpFilename,
  _In_ LPSTR lpComment,
  _In_ DWORD BufferSize
);

Parameter

lpFilename [ In]

Zeiger auf den Namen der Aufzeichnungsdatei.

lpComment [ In]

Zeiger auf eine vorab zugeordnete Zeichenfolge für den Kommentar.

BufferSize [ In]

Größe der Zeichenfolge.

Rückgabewert

Wenn die Funktion erfolgreich ist (d. h. wenn der Kommentar gefunden und kopiert wird oder kein Kommentar in der Aufzeichnungsdatei vorhanden ist), lautet der Rückgabewert NMERR _ SUCCESS.

Wenn die Funktion nicht erfolgreich ist, ist der Rückgabewert ein Fehlercode.

Rückgabecode Beschreibung
NMERR _ FILE READ ERROR (NMERR-DATEILESEFEHLER) _ _
Der Aufzeichnungskommentar kann nicht gelesen werden.
NMERR: _ UNGÜLTIGES _ _ DATEIFORMAT
Der Kommentarrahmen ist kein gültiges Dateiformat.
_NMERR-DATEI _ NICHT _ GEFUNDEN
Die durch den lpFilename-Parameter angegebene Datei kann nicht gefunden werden.
NMERR _ – UNGÜLTIGER _ PARAMETER
Einer der Parameter wird falsch angegeben.

Bemerkungen

Experten und Parser können die GetCaptureCommentFromFilename-Funktion aufrufen.

Um den Kommentar einer Echtzeiterfassung abzurufen, rufen Sie die GetCaptureComment-Funktion auf.

Requirements (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
Bibliothek
Nmapi.lib
DLL
Nmapi.dll

Weitere Informationen

GetCaptureComment