SnmpSetPduData 함수(winsnmp.h)
[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]
WinSNMP SnmpSetPduData 함수는 지정된 SNMP 프로토콜 데이터 단위(PDU)에서 선택한 데이터 필드를 업데이트합니다.
구문
SNMPAPI_STATUS SNMPAPI_CALL SnmpSetPduData(
[in] HSNMP_PDU PDU,
[in] const smiINT *PDU_type,
[in] const smiINT32 *request_id,
[in] const smiINT *non_repeaters,
[in] const smiINT *max_repetitions,
[in] const HSNMP_VBL *varbindlist
);
매개 변수
[in] PDU
SNMP PDU에 대한 핸들입니다.
[in] PDU_type
지정된 PDU의 PDU_type 필드를 업데이트할 값이 있는 변수에 대한 포인터입니다. 이 매개 변수는 NULL일 수도 있습니다.
[in] request_id
지정된 PDU의 request_id 필드를 업데이트할 값이 있는 변수에 대한 포인터입니다. 이 매개 변수는 NULL일 수도 있습니다.
[in] non_repeaters
PDU_type 매개 변수가 SNMP_PDU_GETBULK 동일한 경우 이 매개 변수는 지정된 PDU의 non_repeaters 필드를 업데이트하는 값이 있는 변수를 가리킵니다. Microsoft WinSNMP 구현은 다른 PDU 형식에 대해 이 매개 변수를 무시합니다. 이 매개 변수는 NULL일 수도 있습니다.
[in] max_repetitions
PDU_type 매개 변수가 SNMP_PDU_GETBULK 같으면 이 매개 변수는 지정된 PDU의 max_repetitions 필드를 업데이트할 값이 있는 변수를 가리킵니다. 구현은 다른 PDU 형식에 대해 이 매개 변수를 무시합니다. 이 매개 변수는 NULL일 수도 있습니다.
[in] varbindlist
핸들을 지정된 PDU의 변수 바인딩 목록 필드로 업데이트하는 값이 있는 변수에 대한 포인터입니다. 이 매개 변수는 NULL일 수도 있습니다.
반환 값
함수가 성공하면 반환 값이 SNMPAPI_SUCCESS.
함수가 실패하면 반환 값이 SNMPAPI_FAILURE. 확장된 오류 정보를 얻으려면 SnmpGetLastError를 호출합니다. SnmpGetLastError 함수는 다음 오류 중 하나를 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
SnmpStartup 함수가 성공적으로 완료되지 않았습니다. |
|
메모리 할당 중에 오류가 발생했습니다. |
|
PDU 유형이 잘못되었습니다. |
|
변수 바인딩 목록이 잘못되었습니다. |
|
모든 입력 매개 변수는 NULL입니다. SNMP 작업이 수행되지 않았습니다. |
|
알 수 없거나 정의되지 않은 오류가 발생했습니다. |
설명
SnmpSetPduData 함수의 모든 매개 변수가 필요합니다. 그러나 PDU 매개 변수를 제외한 모든 매개 변수는 NULL일 수 있습니다. WinSNMP 애플리케이션이 매개 변수에서 NULL 을 전달하는 경우 SnmpSetPduData 는 PDU에서 해당 필드를 업데이트하지 않습니다. SnmpSetPduData는 매개 변수를 값에 대한 포인터로 전달하므로 애플리케이션은 여전히 NULL로 PDU 필드를 업데이트할 수 있습니다.
하나의 PDU 필드 값은 단독으로 유효할 수 있지만 다른 필드의 값과 함께 무효화될 수 있습니다. 구현은 애플리케이션이 SnmpSendMsg 또는 SnmpEncodeMsg 함수를 호출할 때 PDU 및 기타 메시지 요소의 유효성 을 검사합니다. 구현에서 잘못된 PTU를 거부합니다.
SnmpSetPduData 함수를 호출하여 업데이트할 수 있는 트랩 PDU의 유일한 유형은 SNMPv2C 트랩 PDU입니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winsnmp.h |
| 라이브러리 | Wsnmp32.lib |
| DLL | Wsnmp32.dll |