Função SnmpDuplicateVbl (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.]
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 |
|---|---|
|
A função SnmpStartup não foi concluída com êxito. |
|
Ocorreu um erro durante a alocação de memória. |
|
O identificador de sessão é inválido. |
|
O parâmetro vbl é inválido. |
|
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 |