SnmpOidCopy 함수(winsnmp.h)

[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]

WinSNMP SnmpOidCopy 함수는 SNMP 개체 식별자를 복사하여 복사본에 필요한 메모리를 할당합니다.

구문

SNMPAPI_STATUS SNMPAPI_CALL SnmpOidCopy(
  [in]  smiLPCOID srcOID,
  [out] smiLPOID  dstOID
);

[in] srcOID

복사할 smiOID 구조체에 대한 포인터입니다.

[out] dstOID

srcOID 매개 변수로 지정된 개체 식별자의 복사본을 수신하는 smiOID 구조체에 대한 포인터입니다.

함수가 성공하면 반환 값은 복사된 개체 식별자의 하위 ID 수입니다. 이 숫자는 dstOID 매개 변수가 가리키는 smiOID 구조체의 len 멤버 값이기도 합니다.

함수가 실패하면 반환 값이 SNMPAPI_FAILURE. 확장 오류 정보를 얻으려면 세션 매개 변수에 NULL 값을 지정하는 SnmpGetLastError를 호출합니다. SnmpGetLastError 함수는 다음 오류 중 하나를 반환할 수 있습니다.

반환 코드	설명
SNMPAPI_NOT_INITIALIZED	SnmpStartup 함수가 성공적으로 완료되지 않았습니다.
SNMPAPI_ALLOC_ERROR	메모리 할당 중에 오류가 발생했습니다.
SNMPAPI_OID_INVALID	srcOID 매개 변수가 잘못되었습니다.
SNMPAPI_OTHER_ERROR	알 수 없거나 정의되지 않은 오류가 발생했습니다.

입력 시 SnmpOidCopy 함수는 dstOID 매개 변수가 가리키는 smiOID 구조체의 멤버를 무시합니다. 함수가 성공적으로 완료되면 Microsoft WinSNMP 구현에서 smiOID 멤버를 덮어씁니다.

WinSNMP 애플리케이션은 구현이 dstOID 매개 변수가 가리키는 smiOID 구조체의 ptr 멤버에 할당된 리소스를 해제할 수 있도록 SnmpFreeDescriptor 함수를 호출해야 합니다. 자세한 내용은 WinSNMP 데이터 관리 개념 및 WinSNMP 설명자 해제를 참조하세요.


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winsnmp.h
라이브러리	Wsnmp32.lib
DLL	Wsnmp32.dll