Partager via


Fonction GetCaptureCommentFromFilename

La fonction GetCaptureCommentFromFilename extrait le commentaire de capture d’un fichier de capture.

Syntaxe

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

Paramètres

lpFilename [in]

Pointeur vers le nom du fichier de capture.

lpComment [in]

Pointeur vers une chaîne pré-allouée pour le commentaire.

BufferSize [in]

Taille de la chaîne.

Valeur retournée

Si la fonction réussit (autrement dit, si le commentaire est trouvé et copié, ou s’il n’y a aucun commentaire dans le fichier de capture), la valeur de retour est NMERR_SUCCESS.

Si la fonction échoue, la valeur de retour est un code d’erreur.

Code de retour Description
NMERR_FILE_READ_ERROR
Impossible de lire le commentaire de capture.
NMERR_INVALID_FILE_FORMAT
Le cadre Commentaire n’est pas un format de fichier valide.
NMERR_FILE_NOT_FOUND
Le fichier spécifié par le paramètre lpFilename est introuvable.
NMERR_INVALID_PARAMETER
L’un des paramètres est spécifié incorrectement.

Notes

Les experts et les analyseurs peuvent appeler la fonction GetCaptureCommentFromFilename .

Pour récupérer le commentaire d’une capture en temps réel, appelez 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

GetCaptureComment