SnmpDeleteVb 함수(winsnmp.h)
[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]
WinSNMP SnmpDeleteVb 함수는 변수 바인딩 목록에서 변수 바인딩 항목을 제거합니다.
구문
SNMPAPI_STATUS SNMPAPI_CALL SnmpDeleteVb(
[in] HSNMP_VBL vbl,
[in] smiUINT32 index
);
매개 변수
[in] vbl
업데이트할 변수 바인딩 목록에 대한 핸들입니다.
[in] index
제거할 변수 바인딩 항목을 식별하는 부호 없는 long 정수 변수를 지정합니다. 이 변수는 변수 바인딩 목록 내에서 변수 바인딩 항목의 위치를 포함합니다.
이 매개 변수의 유효한 값은 1에서 n까지의 범위에 있습니다. 여기서 1은 변수 바인딩 목록의 첫 번째 변수 바인딩 항목을 나타내고 n은 변수 바인딩 목록의 총 항목 수입니다. 자세한 내용은 다음 설명 섹션을 참조하세요.
반환 값
함수가 성공하면 반환 값이 SNMPAPI_SUCCESS.
함수가 실패하면 반환 값이 SNMPAPI_FAILURE. 확장 오류 정보를 얻으려면 SnmpGetLastError를 호출합니다. SnmpGetLastError 함수는 다음 오류 중 하나를 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
SnmpStartup 함수가 성공적으로 완료되지 않았습니다. |
|
메모리 할당 중에 오류가 발생했습니다. |
|
인덱스 매개 변수가 잘못되었습니다. |
|
vbl 매개 변수가 잘못되었습니다. |
|
알 수 없거나 정의되지 않은 오류가 발생했습니다. |
설명
WinSNMP 애플리케이션은 SnmpDeleteVb 함수를 사용하여 잘못된 변수 바인딩 항목을 삭제할 수 있습니다. SNMP_PDU_RESPONSE 프로토콜 데이터 단위(PDU)에 잘못된 변수 바인딩 항목을 나타내는 오류가 포함된 경우 애플리케이션은 SnmpDeleteVb를 호출하여 항목을 삭제할 수 있습니다. 그런 다음 애플리케이션은 변수 바인딩 목록에 잘못된 변수 바인딩 항목 없이 SnmpSendMsg 함수를 호출하여 요청 PDU를 다시 제출할 수 있습니다. 요청 PDU에는 SNMP_PDU_GET, SNMP_PDU_GETNEXT 및 SNMP_PDU_GETBULK PDU 데이터 형식이 포함됩니다.
SnmpDeleteVb 함수가 변수 바인딩 항목을 삭제하면 삭제된 항목 이후의 모든 항목의 인덱스 값이 1씩 감소합니다. SnmpCountVbl 함수를 호출하면 변수 바인딩 목록의 새 총 항목 수가 반환됩니다. 새 합계는 SnmpDeleteVb에 대한 현재 호출 전에 SnmpCountVbl 호출에서 반환된 개수보다 1보다 작습니다.
WinSNMP 애플리케이션이 SnmpDeleteVb 함수를 호출하고 변수 바인딩 목록에서 마지막 변수 바인딩 항목을 삭제하는 경우 결과는 빈 변수 바인딩 목록입니다. 변수 바인딩 목록에는 여전히 유효한 핸들이 있으며 WinSNMP 애플리케이션은 SnmpFreeVbl 함수를 호출하여 핸들을 해제해야 합니다.
다음은 인덱 스 매개 변수에 사용할 유효한 값입니다.
- SnmpCountVbl 함수 호출의 반환 값입니다.
- SnmpRecvMsg 함수를 호출하여 반환된 SNMP_PDU_RESPONSE PDU의 오류 인덱스 필드
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winsnmp.h |
| 라이브러리 | Wsnmp32.lib |
| DLL | Wsnmp32.dll |