Função GetCaptureComment
A função GetCaptureComment retorna um ponteiro para o comentário de uma captura.
LPSTR WINAPI GetCaptureComment(
_In_ HCAPTURE hCapture
);
-
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.
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.
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 .
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 |
|
Biblioteca |
|
DLL |
|