SnmpSetVb 함수(winsnmp.h)
[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]
WinSNMP SnmpSetVb 함수는 변수 바인딩 목록의 변수 바인딩 항목을 변경합니다. 또한 이 함수는 기존 변수 바인딩 목록에 새 변수 바인딩 항목을 추가합니다.
구문
SNMPAPI_STATUS SNMPAPI_CALL SnmpSetVb(
[in] HSNMP_VBL vbl,
[in] smiUINT32 index,
[in] smiLPCOID name,
[in] smiLPCVALUE value
);
매개 변수
[in] vbl
업데이트할 변수 바인딩 목록에 대한 핸들입니다.
[in] index
변수 바인딩 목록 내에서 변수 바인딩 항목의 위치(업데이트 작업인 경우)를 포함하는 부호 없는 긴 정수 변수를 지정합니다. 이 작업이 추가 작업인 경우 이 매개 변수는 0과 같아야 합니다. 자세한 내용은 아래 설명 부분을 참조하십시오.
[in] name
추가하거나 변경할 변수의 이름을 나타내는 smiOID 구조체에 대한 포인터입니다. 자세한 내용은 아래 설명 부분을 참조하십시오.
[in] value
smiVALUE 구조체에 대한 포인터입니다. 구조체에는 name 매개 변수로 지정된 변수와 연결된 값이 포함됩니다.
반환 값
함수가 성공하면 반환 값은 변수 바인딩 목록에서 업데이트되거나 추가된 변수 바인딩 항목의 위치입니다. 자세한 내용은 다음 설명 섹션을 참조하세요.
함수가 실패하면 반환 값이 SNMPAPI_FAILURE. 확장 오류 정보를 얻으려면 SnmpGetLastError를 호출합니다. SnmpGetLastError 함수는 다음 오류 중 하나를 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
SnmpStartup 함수가 성공적으로 완료되지 않았습니다. |
|
메모리 할당 중에 오류가 발생했습니다. |
|
vbl 매개 변수가 잘못되었습니다. |
|
인덱스 매개 변수가 잘못되었습니다. |
|
name 매개 변수가 잘못되었습니다. |
|
값 매개 변수가 가리키는 구조체의 구문 멤버가 잘못되었습니다. |
|
알 수 없거나 정의되지 않은 오류가 발생했습니다. |
설명
인덱스 매개 변수 범위의 유효한 값은 0에서 n까지입니다. 값 0은 추가 작업을 나타냅니다. 값 n은 변수 바인딩 목록에 있는 변수 바인딩 항목의 총 수입니다. WinSNMP 애플리케이션은 SnmpSetVb 를 호출하여 총 변수 바인딩 항목 수를 가져오기 전에 SnmpCountVbl 함수를 호출해야 합니다.
함수가 업데이트 작업을 성공적으로 수행하면 반환 값이 인덱 스 매개 변수의 값과 같습니다. 함수가 변수 바인딩 항목을 추가하는 경우 반환 값은 n + 1입니다.
name 매개 변수가 NULL이 아니지만 값 매개 변수가 NULL인 경우 Microsoft WinSNMP 구현은 값 멤버가 NULL로 설정되고 구문 멤버가 SNMP_SYNTAX_ 설정된 새 변수 바인딩 항목을 초기화합니다.
인덱스 매개 변수가 0이 아니고 이름 매개 변수가 NULL인 경우 Microsoft WinSNMP 구현은 인덱스 매개 변수가 가리키는 변수의 값만 업데이트합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winsnmp.h |
| 라이브러리 | Wsnmp32.lib |
| DLL | Wsnmp32.dll |