Método IStats::GetConversationStatistics
O método GetConversationStatistics recupera informações de sessão e estação sobre a captura atual.
Sintaxe
HRESULT STDMETHODCALLTYPE GetConversationStatistics(
[out] DWORD *nSessions,
[out] LPSESSIONSTATS lpSessionStats,
[out] DWORD *nStations,
[out] LPSTATIONSTATS lpStationStats,
[in] BOOL fClearAfterReading
);
Parâmetros
-
nSessions [out]
-
Um ponteiro para um DWORD que contém o número de sessões registradas para a captura atual.
-
lpSessionStats [out]
-
Um ponteiro para uma estrutura SESSIONSTATS .
-
nStations [out]
-
Um ponteiro para um DWORD que contém o número de estações registradas para a captura atual.
-
lpStationStats [out]
-
Um ponteiro para uma estrutura STATIONSTATS .
-
fClearAfterReading [in]
-
Sinalizador usado para instruir o Monitor de Rede a limpar o armazenamento interno das estruturas SESSIONSTATS e STATIONSTATS após a recuperação dos dados atuais.
Valor retornado
Se o método for bem-sucedido, o valor retornado será NMERR_SUCCESS.
Se o método não for bem-sucedido, o valor retornado será um dos seguintes códigos de erro:
| Código de retorno | Descrição |
|---|---|
|
O NPP não está conectado à rede. Chame IStats::Connect para conectar o NPP à rede. |
|
O NPP não está capturando dados. Chame IStats::Start para iniciar a captura. |
|
O NPP está conectado à rede, mas não com o método IStats::Connect . |
|
A configuração dessa conexão é definida para não salvar estatísticas de conversa. Para salvar estatísticas de conversa, interrompa a captura, defina NoConversationStats = YES no BLOB de configuração e reinicie a captura. |
Comentários
Esse método só pode ser chamado enquanto a captura de dados estiver em andamento; quando a captura atual for pausada, uma chamada para esse método não terá êxito.
Para iniciar uma captura, chame o método IStats::Start . Para recuperar outros tipos de estatísticas, chame IStats::GetTotalStatistics.
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 |
|
| DLL |
|