Función GetCaptureComment

La función GetCaptureComment devuelve un puntero al comentario de una captura.

Sintaxis

LPSTR WINAPI GetCaptureComment(
  _In_ HCAPTURE hCapture
);

Parámetros

hCapture [in]

Identificador de la captura. Para obtener más información sobre cómo obtener el identificador de captura, vea la sección Comentarios.

Valor devuelto

Si la función es correcta (es decir, si la captura contiene un comentario), el valor devuelto es un puntero a la cadena de comentario.

Si la función no se realiza correctamente, el valor devuelto es NULL.

Comentarios

No modifique la cadena de comentario devuelta, que es la cadena de comentario real que se encuentra en la captura cargada. Los cambios pueden dañar la captura. Los intentos de modificar la cadena producen una infracción de acceso.

El identificador de la captura se puede obtener de varias maneras, dependiendo de si un experto o analizador realiza la llamada. En el caso de los expertos, el identificador se especifica en el miembro hCapture de la estructura EXPERTSTARTUPINFO . Para los analizadores, el identificador de captura se puede obtener llamando a la función GetFrameCaptureHandle .

Para recuperar el comentario de una captura de su archivo de captura, llame a la función GetCaptureCommentFromFilename .

Los expertos y analizadores pueden llamar a la función GetCaptureComment .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Netmon.h
Biblioteca	Nmapi.lib
Archivo DLL	Nmapi.dll

Consulte también

EXPERTSTARTUPINFO

GetCaptureCommentFromFilename

GetFrameCaptureHandle