Função SnmpCreateVbl (winsnmp.h)

Artigo
08/27/2023

[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 SnmpCreateVbl cria uma nova lista de associações de variáveis para o aplicativo WinSNMP de chamada. Se os parâmetros name e value não forem NULL, SnmpCreateVbl usará seus valores para criar a primeira entrada de associação de variável para a nova lista de associações de variáveis. A função SnmpCreateVbl retorna um identificador para a nova lista de associações de variáveis e aloca qualquer memória necessária para ela.

Sintaxe

HSNMP_VBL SNMPAPI_CALL SnmpCreateVbl(
  [in] HSNMP_SESSION session,
  [in] smiLPCOID     name,
  [in] smiLPCVALUE   value
);

Parâmetros

[in] session

Manipule para a sessão WinSNMP.

[in] name

Ponteiro para uma estrutura smiOID que contém o nome da variável para a primeira entrada de associação de variável. Este parâmetro pode ser NULL. Para obter informações adicionais, consulte a seção Comentários a seguir.

[in] value

Ponteiro para uma estrutura smiVALUE que contém um valor a ser associado à variável na primeira entrada de associação de variável. Este parâmetro pode ser NULL. Para obter informações adicionais, consulte a seção Comentários a seguir.

Valor retornado

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_OID_INVALID	O parâmetro name faz referência a uma estrutura smiOID inválida.
SNMPAPI_SYNTAX_INVALID	O membro de sintaxe da estrutura apontada pelo parâmetro value é inválido.
SNMPAPI_OTHER_ERROR	Ocorreu um erro desconhecido ou indefinido.

Comentários

A função SnmpCreateVbl usa os valores dos parâmetros name e value para criar e inicializar a primeira entrada de associação de variável de uma nova lista de associações de variáveis. Se o parâmetro name for NULL, a implementação do Microsoft WinSNMP ignorará o parâmetro value e criará uma lista de associações de variáveis vazia.

Se o parâmetro name não for NULL, mas o parâmetro value for NULL, a implementação criará e inicializará a primeira entrada de associação de variável na lista de associações de variáveis. Ele inicializa o membro de sintaxe da estrutura apontada pelo parâmetro value com o valor SNMP_SYNTAX_NULL.

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 variáveis em uma chamada subsequente para SnmpCreateVbl ou SnmpDuplicateVbl. Para obter informações adicionais, consulte Conceitos de Gerenciamento de Dados WinSNMP.

Requisitos


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