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 |
|
| Bibliothek |
|
| DLL |
|