GetCaptureComment-Funktion

Die GetCaptureComment-Funktion gibt einen Zeiger auf den Kommentar einer Erfassung zurück.

Syntax

LPSTR WINAPI GetCaptureComment(
  _In_ HCAPTURE hCapture
);

Parameter

hCapture [ In]

Ein Handle für die Erfassung. Weitere Informationen zum Abrufen des Erfassungshandpunkts finden Sie im Abschnitt "Hinweise".

Rückgabewert

Wenn die Funktion erfolgreich ist (d. h., wenn die Erfassung einen Kommentar enthält), ist der Rückgabewert ein Zeiger auf die Kommentarzeichenfolge.

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

Bemerkungen

Ändern Sie die zurückgegebene Kommentarzeichenfolge nicht. Dies ist die tatsächliche Kommentarzeichenfolge in der geladenen Erfassung. Alle Änderungen können die Erfassung beschädigt. Versuche, die Zeichenfolge zu ändern, führen zu einer Zugriffsverletzung.

Das Handle der Erfassung kann auf verschiedene Weise erhalten werden, je nachdem, ob der Aufruf von einem Experten oder Parser erfolgt. Für Experten wird das Handle im hCapture-Element der EXPERTSTARTUPINFO-Struktur angegeben. Für Parser kann das Erfassungshandle durch Aufrufen der GetFrameCaptureHandle-Funktion ermittelt werden.

Um den Kommentar einer Erfassung aus der Erfassungsdatei abzurufen, rufen Sie die GetCaptureCommentFromFilename-Funktion auf.

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

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

EXPERTSTARTUPINFO

GetCaptureCommentFromFilename

GetFrameCaptureHandle