Compartilhar via


Função SnmpCountVbl (winsnmp.h)

[O SNMP está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use o Gerenciamento Remoto do Windows, que é a implementação da Microsoft do WS-Man.]

Um aplicativo WinSNMP chama a função WinSNMP SnmpCountVbl para enumerar as entradas de associação de variável na lista de associações de variáveis especificada.

Sintaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpCountVbl(
  [in] HSNMP_VBL vbl
);

Parâmetros

[in] vbl

Manipule para a lista de associações de variáveis para enumerar.

Retornar valor

Se a função for bem-sucedida, o valor retornado será a contagem de entradas de associação de variáveis na lista de associações de variáveis.

Se a função falhar, o valor retornado será SNMPAPI_FAILURE. Para obter informações de erro estendidas, chame SnmpGetLastError especificando um valor NULL em seu parâmetro de sessão . A função SnmpGetLastError pode retornar um dos erros a seguir.

Código de retorno Descrição
SNMPAPI_NOT_INITIALIZED
A função SnmpStartup não foi concluída com êxito.
SNMPAPI_ALLOC_ERROR
Ocorreu um erro durante a alocação de memória.
SNMPAPI_NOOP
A lista de associações de variáveis não contém nenhuma entrada de associação variável no momento.
SNMPAPI_VBL_INVALID
O parâmetro vbl é inválido.
SNMPAPI_OTHER_ERROR
Ocorreu um erro desconhecido ou indefinido.

Comentários

A função SnmpCountVbl retorna um valor inteiro sem sinal que é o valor máximo que o aplicativo WinSNMP pode especificar para o parâmetro de índice nas funções SnmpGetVb, SnmpSetVb e SnmpDeleteVb .

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]
Plataforma de Destino Windows
Cabeçalho winsnmp.h
Biblioteca Wsnmp32.lib
DLL Wsnmp32.dll

Confira também

SnmpDeleteVb

SnmpGetVb

SnmpSetVb

Funções WinSNMP

Visão geral da API do WinSNMP