Compartilhar via

Função SnmpDuplicateVbl (winsnmp.h)

  • Artigo

[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.]

A função WinSNMP SnmpDuplicateVbl copia uma lista de associações de variáveis para a sessão WinSNMP especificada. Essa função retorna um identificador para a lista de associações de variáveis copiadas e aloca qualquer memória necessária para ela.

Sintaxe

HSNMP_VBL SNMPAPI_CALL SnmpDuplicateVbl(
  [in] HSNMP_SESSION session,
  [in] HSNMP_VBL     vbl
);

Parâmetros

[in] session

Manipule para a sessão WinSNMP.

[in] vbl

Manipule para a lista de associações de variáveis a serem copiadas. A lista de associações de variável de origem pode estar vazia.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para uma nova 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. 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_SESSION_INVALID
 O identificador de sessão é inválido.
SNMPAPI_VBL_INVALID
 O parâmetro vbl é inválido.
SNMPAPI_OTHER_ERROR
 Ocorreu um erro desconhecido ou indefinido.

Comentários

A função SnmpDuplicateVbl cria uma nova lista de associações de variáveis para a sessão WinSNMP especificada. Essa função inicializa a nova lista com uma cópia dos dados na lista de associações de variáveis de origem.

O identificador que a função SnmpDuplicateVbl retorna é exclusivo entre os identificadores de lista de associações de variáveis que estão ativos no aplicativo WinSNMP.

O aplicativo WinSNMP deve liberar os recursos associados a cada lista de associações de variáveis. Ele deve fazer isso correspondendo cada chamada às funções SnmpCreateVbl e SnmpDuplicateVbl com uma chamada correspondente à função SnmpFreeVbl . Para evitar vazamentos de memória, um aplicativo WinSNMP deve chamar SnmpFreeVbl antes de reutilizar o identificador para uma lista de associações de variáveis em uma chamada subsequente para SnmpCreateVbl ou SnmpDuplicateVbl. Para obter informações adicionais, consulte Conceitos de Gerenciamento de Dados do WinSNMP.

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

SnmpCreateVbl

SnmpFreeVbl

Funções WinSNMP

Visão geral da API do WinSNMP