SnmpUtilIdsToA 함수(snmp.h)
[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]
SnmpUtilIdsToA 함수는 OID(개체 식별자)를 null로 끝나는 문자열로 변환합니다. 이 함수는 SNMP 유틸리티 API의 요소입니다.
구문
LPSTR SNMP_FUNC_TYPE SnmpUtilIdsToA(
[in] UINT *Ids,
[in] UINT IdLength
);
매개 변수
[in] Ids
부호 없는 정수 배열에 대한 포인터입니다. 배열에는 OID에 포함된 숫자 시퀀스가 포함됩니다. IdLength 매개 변수는 배열의 길이를 지정합니다.
자세한 내용은 다음 반환 값 및 비고 섹션을 참조하세요.
[in] IdLength
Ids 매개 변수가 가리키는 배열의 요소 수를 지정합니다.
반환 값
함수는 Ids 매개 변수가 가리키는 숫자 배열의 문자열 표현을 포함하는 null로 끝나는 문자열을 반환합니다. 문자열에는 마침표('.')로 구분된 숫자 시퀀스가 포함되어 있습니다. 예를 들어 1.3.6.1.4.1.311입니다.
Ids 매개 변수가 null이거나 IdLength 매개 변수가 0을 지정하는 경우 함수는 문자열 "<null oid>"를 반환합니다.
반환된 문자열의 최대 길이는 256자입니다. 문자열의 길이가 256자를 초과하면 문자열이 잘리고 3개의 마침표('...')로 종료됩니다.
설명
SnmpUtilIdsToA 함수는 SNMP 애플리케이션의 디버깅을 지원할 수 있습니다.
SnmpUtilIdsToA를 호출할 때 다음 메모리 제한이 적용됩니다.
- Ids 매개 변수는 IdLength 정수 이상의 유효한 메모리 블록을 가리키거나 함수 호출로 인해 액세스 위반 예외가 발생합니다.
- SnmpUtilIdsToA에서 반환된 문자열은 SNMP 유틸리티 API가 할당하는 메모리에 있습니다. 애플리케이션은 메모리 할당에 대해 어떠한 가정도 하지 않아야 합니다. SnmpUtilIdsToA를 다시 호출할 때까지 데이터가 유효하도록 보장되므로 함수를 다시 호출하기 전에 데이터를 다른 위치에 복사해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | snmp.h |
| 라이브러리 | Snmpapi.lib |
| DLL | Snmpapi.dll |