Compartilhar via


Função GetCaptureCommentFromFilename

A função GetCaptureCommentFromFilename extrai o comentário de captura de um arquivo de captura.

Sintaxe

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

Parâmetros

lpFilename [in]

Ponteiro para o nome do arquivo de captura.

lpComment [in]

Ponteiro para uma cadeia de caracteres pré-alocada para o comentário.

BufferSize [in]

Tamanho da cadeia de caracteres.

Valor retornado

Se a função for bem-sucedida (ou seja, se o comentário for encontrado e copiado ou não houver nenhum comentário no arquivo de captura), o valor retornado será NMERR_SUCCESS.

Se a função não for bem-sucedida, o valor retornado será um código de erro.

Código de retorno Descrição
NMERR_FILE_READ_ERROR
O comentário de captura não pode ser lido.
NMERR_INVALID_FILE_FORMAT
O quadro Comentário não é um formato de arquivo válido.
NMERR_FILE_NOT_FOUND
O arquivo especificado pelo parâmetro lpFilename não pode ser encontrado.
NMERR_INVALID_PARAMETER
Um dos parâmetros é especificado incorretamente.

Comentários

Especialistas e analisadores podem chamar a função GetCaptureCommentFromFilename .

Para recuperar o comentário de uma captura em tempo real, chame a função GetCaptureComment .

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Netmon.h
Biblioteca
Nmapi.lib
DLL
Nmapi.dll

Confira também

GetCaptureComment