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