Ler em inglês

Compartilhar via


Função GetCaptureComment

A função GetCaptureComment retorna um ponteiro para o comentário de uma captura.

Sintaxe

LPSTR WINAPI GetCaptureComment(
  _In_ HCAPTURE hCapture
);

Parâmetros

hCapture [in]

Um identificador para a captura. Para obter mais informações sobre como obter o identificador de captura, consulte a seção Comentários.

Valor retornado

Se a função for bem-sucedida (ou seja, se a captura contiver um comentário), o valor retornado será um ponteiro para a cadeia de caracteres de comentário.

Se a função não for bem-sucedida, o valor retornado será NULL.

Comentários

Não altere a cadeia de caracteres de comentário retornada, que é a cadeia de caracteres de comentário real que está na captura carregada. Qualquer alteração pode corromper a captura. Tentativas de modificar a cadeia de caracteres resultam em uma violação de acesso.

O identificador da captura pode ser obtido de várias maneiras, dependendo se a chamada for feita por um especialista ou analisador. Para especialistas, o identificador é especificado no membro hCapture da estrutura EXPERTSTARTUPINFO . Para analisadores, o identificador de captura pode ser obtido chamando a função GetFrameCaptureHandle .

Para recuperar o comentário de uma captura de seu arquivo de captura, chame a função GetCaptureCommentFromFilename .

Especialistas e analisadores podem chamar 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

EXPERTSTARTUPINFO

GetCaptureCommentFromFilename

GetFrameCaptureHandle