SnmpCreateVbl 함수(winsnmp.h)

아티클
08/27/2023

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

WinSNMP SnmpCreateVbl 함수는 호출하는 WinSNMP 애플리케이션에 대한 새 변수 바인딩 목록을 만듭니다. 이름 및 값 매개 변수가 NULL이 아닌 경우 SnmpCreateVbl은 해당 값을 사용하여 새 변수 바인딩 목록에 대한 첫 번째 변수 바인딩 항목을 만듭니다. SnmpCreateVbl 함수는 새 변수 바인딩 목록에 대한 핸들을 반환하고 필요한 메모리를 할당합니다.

구문

HSNMP_VBL SNMPAPI_CALL SnmpCreateVbl(
  [in] HSNMP_SESSION session,
  [in] smiLPCOID     name,
  [in] smiLPCVALUE   value
);

매개 변수

[in] session

WinSNMP 세션에 대한 핸들입니다.

[in] name

첫 번째 변수 바인딩 항목의 변수 이름을 포함하는 smiOID 구조체에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. 자세한 내용은 다음 설명 섹션을 참조하세요.

[in] value

첫 번째 변수 바인딩 항목에서 변수와 연결할 값을 포함하는 smiVALUE 구조체에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. 자세한 내용은 다음 설명 섹션을 참조하세요.

반환 값

함수가 성공하면 반환 값은 새 변수 바인딩 목록에 대한 핸들입니다.

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

반환 코드	설명
SNMPAPI_NOT_INITIALIZED	SnmpStartup 함수가 성공적으로 완료되지 않았습니다.
SNMPAPI_ALLOC_ERROR	메모리 할당 중에 오류가 발생했습니다.
SNMPAPI_SESSION_INVALID	세션 핸들이 잘못되었습니다.
SNMPAPI_OID_INVALID	name 매개 변수는 잘못된 smiOID 구조를 참조합니다.
SNMPAPI_SYNTAX_INVALID	값 매개 변수가 가리키는 구조체의 구문 멤버가 잘못되었습니다.
SNMPAPI_OTHER_ERROR	알 수 없거나 정의되지 않은 오류가 발생했습니다.

설명

SnmpCreateVbl 함수는 이름 및 값 매개 변수의 값을 사용하여 새 변수 바인딩 목록의 첫 번째 변수 바인딩 항목을 만들고 초기화합니다. name 매개 변수가 NULL인 경우 Microsoft WinSNMP 구현은 값 매개 변수를 무시하고 빈 변수 바인딩 목록을 만듭니다.

name 매개 변수가 NULL이 아니지만 값 매개 변수가 NULL인 경우 구현은 변수 바인딩 목록에서 첫 번째 변수 바인딩 항목을 만들고 초기화합니다. 값 매개 변수가 가리키는 구조체의 구문 멤버를 SNMP_SYNTAX_NULL 값으로 초기화합니다.

WinSNMP 애플리케이션은 각 변수 바인딩 목록과 연결된 리소스를 해제해야 합니다. SnmpCreateVbl 및 SnmpDuplicateVbl 함수에 대한 각 호출을 SnmpFreeVbl 함수에 대한 해당 호출 과 일치시켜 이 작업을 수행해야 합니다. 메모리 누수 방지를 위해 WinSNMP 애플리케이션은 SnmpCreateVbl 또는 SnmpDuplicateVbl에 대한 후속 호출에서 핸들을 변수 바인딩 목록에 다시 사용하기 전에 SnmpFreeVbl을 호출해야 합니다. 자세한 내용은 WinSNMP 데이터 관리 개념을 참조하세요.

요구 사항


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