다음을 통해 공유

Dhcpv6RequestParams 함수(dhcpv6csdk.h)

  • 아티클

Dhcpv6RequestParams 함수는 DHCPv6 클라이언트 캐시 또는 DHCPv6 서버에서 직접 옵션을 요청합니다.

구문

DWORD Dhcpv6RequestParams(
  BOOL                    forceNewInform,
  LPVOID                  reserved,
  LPWSTR                  adapterName,
  LPDHCPV6CAPI_CLASSID    classId,
  DHCPV6CAPI_PARAMS_ARRAY recdParams,
  LPBYTE                  buffer,
  LPDWORD                 pSize
);

매개 변수

forceNewInform

이 값을 TRUE로 설정하면 사용 가능한 캐시된 정보가 무시되고 새 정보가 요청됩니다. 그렇지 않으면 캐시된 정보가 없는 경우에만 요청이 전송됩니다.

reserved

다음에 사용하도록 예약됩니다. NULL로 설정해야 합니다.

adapterName

이 요청이 의도된 어댑터의 GUID입니다. 이 매개 변수는 NULL이 아니어야 합니다.

classId

유선으로 보내는 데 사용할 이진 ClassId 정보가 포함된 DHCPV6CAPI_CLASSID 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항입니다.

recdParams

DHCPV6 서버에서 수신할 매개 변수를 포함하는 DHCPV6CAPI_PARAMS_ARRAY 구조체입니다.

buffer

recdParams의 일부 포인터에서 반환된 정보를 포함하는 버퍼입니다.

pSize

버퍼의 크기입니다. 함수가 ERROR_MORE_DATA 반환하면 이 매개 변수는 작업을 완료하는 데 필요한 크기(바이트)를 포함합니다. 함수가 성공하면 이 매개 변수에는 사용된 바이트 수가 포함됩니다.

반환 값

성공적으로 완료되면 ERROR_SUCCESS 반환합니다.

반환 코드 설명
ERROR_INVALID_PARAMETER
 다음 조건 중 하나가 true이면 반환됩니다.
  • reserved 에는 NULL이 아닌 값이 있습니다.
  • AdapterName 이 NULL입니다. 또는 GUID가 지정된 어댑터를 찾을 수 없습니다.
  • pSize 가 NULL입니다.
  • 버퍼 는 NULL입니다.
ERROR_MORE_DATA
 이 API에 대한 호출은 Buffer 매개 변수에 할당된 메모리가 부족하고 pSize 에는 필요한 실제 메모리 크기가 포함되어 있습니다.
ERROR_INVALID_NAME
 AdapterName이 올바른 형식이 아닙니다. 형식 {00000000-0000-0000-0000-000000000000}이어야 합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 dhcpv6csdk.h
라이브러리 Dhcpcsvc6.lib
DLL Dhcpcsvc6.dll