Partager via


GetCaptureComment, fonction

La fonction GetCaptureComment retourne un pointeur vers le commentaire d’une capture.

Syntaxe

LPSTR WINAPI GetCaptureComment(
  _In_ HCAPTURE hCapture
);

Paramètres

hCapture [in]

Handle de la capture. Pour plus d’informations sur l’obtention du handle de capture, consultez la section Remarques.

Valeur retournée

Si la fonction réussit (autrement dit, si la capture contient un commentaire), la valeur de retour est un pointeur vers la chaîne de commentaire.

Si la fonction échoue, la valeur de retour est NULL.

Notes

Ne modifiez pas la chaîne de commentaire retournée, qui est la chaîne de commentaire réelle qui se trouve dans la capture chargée. Toute modification peut endommager la capture. Les tentatives de modification de la chaîne entraînent une violation d’accès.

Le handle de la capture peut être obtenu de plusieurs façons, selon que l’appel est effectué par un expert ou un analyseur. Pour les experts, le handle est spécifié dans le membre hCapture de la structure EXPERTSTARTUPINFO . Pour les analyseurs, le handle de capture peut être obtenu en appelant la fonction GetFrameCaptureHandle .

Pour récupérer le commentaire d’une capture à partir de son fichier de capture, appelez la fonction GetCaptureCommentFromFilename .

Les experts et les analyseurs peuvent appeler la fonction GetCaptureComment .

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server [applications de bureau uniquement]
En-tête
Netmon.h
Bibliothèque
Nmapi.lib
DLL
Nmapi.dll

Voir aussi

EXPERTSTARTUPINFO

GetCaptureCommentFromFilename

GetFrameCaptureHandle