DhcpGetClientInfoVQ 함수(dhcpsapi.h)

DhcpGetClientInfoVQ 함수는 DHCP 서버 데이터베이스에서 DHCP 클라이언트 임대 레코드 정보를 검색합니다.

구문

DWORD DHCP_API_FUNCTION DhcpGetClientInfoVQ(
  [in]  DHCP_CONST WCHAR            *ServerIpAddress,
  [in]  DHCP_CONST DHCP_SEARCH_INFO *SearchInfo,
  [out] LPDHCP_CLIENT_INFO_VQ       *ClientInfo
);

매개 변수

[in] ServerIpAddress

DHCP 서버의 IP 주소 또는 호스트 이름을 지정하는 유니코드 문자열입니다.

[in] SearchInfo

DHCP 서버의 클라이언트 임대 레코드 데이터베이스에서 특정 클라이언트 레코드를 검색하는 데 사용되는 키를 정의하는 DHCP_SEARCH_INFO 구조체에 대한 포인터입니다.

[out] ClientInfo

성공적인 검색 작업에서 반환된 DHCP_CLIENT_INFO_VQ 구조체에 대한 포인터입니다.

반환 값

이 함수는 성공적으로 호출되면 ERROR_SUCCESS 반환합니다. 그렇지 않으면 DHCP 서버 관리 API 오류 코드 중 하나를 반환합니다.

반환 코드	설명
ERROR_ACCESS_DENIED	이 호출은 "DHCP 관리자" 보안 그룹의 구성원이 아닌 클라이언트에 의해 수행되었습니다.
ERROR_DHCP_JET_ERROR	DHCP 서버의 데이터베이스에 액세스하는 동안 오류가 발생했습니다.

설명

이 함수의 호출자는 ClientInfo에서 반환된 DHCP_CLIENT_INFO_VQ 구조체에서 사용하는 메모리를 해제해야 합니다.

요구 사항

지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	dhcpsapi.h
라이브러리	Dhcpsapi.lib
DLL	Dhcpsapi.dll

추가 정보

DHCP_CLIENT_INFO_VQ

DHCP_SEARCH_INFO