SnmpGetTimeout 함수(winsnmp.h)
[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]
WinSNMP SnmpGetTimeout 함수는 SNMP 메시지 요청 전송에 대한 시간 제한 값을 100초 안에 반환합니다. 제한 시간 값은 WinSNMP 애플리케이션이 지정된 관리 엔터티에 대한 SnmpSendMsg 함수에 대해 수행하는 호출에 적용됩니다.
구문
SNMPAPI_STATUS SNMPAPI_CALL SnmpGetTimeout(
[in] HSNMP_ENTITY hEntity,
[out] smiLPTIMETICKS nPolicyTimeout,
[out] smiLPTIMETICKS nActualTimeout
);
매개 변수
[in] hEntity
관심 있는 대상 관리 엔터티에 대한 핸들입니다.
[out] nPolicyTimeout
지정된 관리 엔터티에 대한 시간 제한 값을 100초 단위로 받을 정수 변수에 대한 포인터입니다. 이는 Microsoft WinSNMP 구현이 데이터베이스에 저장하는 값입니다. 이 매개 변수에 반환된 정보가 필요하지 않은 경우 nPolicyRetry 는 NULL 포인터여야 합니다.
[out] nActualTimeout
구현에서 보고한 대상 엔터티에 대한 마지막 실제 또는 예상 응답 간격을 수신하는 정수 변수에 대한 포인터입니다. 이 매개 변수에 반환된 정보가 필요하지 않은 경우 nActualRetry 는 NULL 포인터여야 합니다. 이 매개 변수가 유효한 포인터인 경우 함수는 0을 반환합니다. 자세한 내용은 다음 설명 섹션을 참조하세요.
반환 값
함수가 성공하면 반환 값이 SNMPAPI_SUCCESS.
함수가 실패하면 반환 값이 SNMPAPI_FAILURE. 확장 오류 정보를 얻으려면 세션 매개 변수에서 NULL 값을 지정하는 SnmpGetLastError를 호출합니다. SnmpGetLastError 함수는 다음 오류 중 하나를 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
SnmpStartup 함수가 성공적으로 완료되지 않았습니다. |
|
메모리 할당 중에 오류가 발생했습니다. |
|
hEntity 매개 변수가 잘못되었습니다. |
|
nPolicyRetry 및 nActualRetry 매개 변수는 모두 NULL입니다. 작업이 수행되지 않았습니다. |
|
알 수 없거나 정의되지 않은 오류가 발생했습니다. |
설명
일반적으로 에이전트 애플리케이션이 아닌 WinSNMP 애플리케이션은 SnmpGetTimeout 함수를 호출합니다.
제한 시간은 애플리케이션이 SnmpSendMsg 함수를 호출하고 SnmpRecvMsg 함수를 호출하는 간격입니다.
WinSNMP 애플리케이션은 SnmpSetTimeout 함수를 호출하여 제한 시간 값을 수정할 수 있습니다.
WinSNMP 애플리케이션은 nActualRetry 매개 변수의 값을 모니터링하고 nPolicyRetry 매개 변수의 값과 비교하여 전송 성능을 최적화할 수 있습니다. 자세한 내용은 재전송 정보 및 재전 송 정책 관리를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winsnmp.h |
| 라이브러리 | Wsnmp32.lib |
| DLL | Wsnmp32.dll |