PxeDhcpv6GetOptionValue 함수(wdspxe.h)

DHCPv6 패킷에서 옵션 값을 검색합니다.

구문

DWORD PXEAPI PxeDhcpv6GetOptionValue(
  [in]            PVOID pPacket,
  [in]            ULONG uPacketLen,
  [in]            ULONG uInstance,
  [in]            WORD  wOption,
  [out, optional] PWORD pwOptionLen,
  [out, optional] PVOID *ppOptionValue
);

매개 변수

[in] pPacket

PxePacketAllocate 함수를 사용하여 할당된 회신 패킷에 대한 포인터입니다.

[in] uPacketLen

pReplyPacket 매개 변수가 가리키는 패킷의 길이입니다.

[in] uInstance

검색할 wOption 매개 변수의 instance 지정하는 1 기반 인덱스입니다.

[in] wOption

값을 검색할 옵션입니다.

[out, optional] pwOptionLen

옵션 값의 길이를 받을 WORD 의 주소입니다.

[out, optional] ppOptionValue

패킷 내의 옵션 값 주소를 수신하는 PVOID 의 주소입니다.

반환 값

일반적인 반환 값은 다음 표에 나와 있습니다. 다른 모든 오류의 경우 적절한 Windows 오류 코드가 반환됩니다.

반환 코드/값	설명
ERROR_SUCCESS 0(0x0)	옵션을 찾았고 값에 대한 포인터가 반환되었습니다.
ERROR_FILE_NOT_FOUND 2(0x2)	옵션이 없습니다.
ERROR_INVALID_DATA 13(0xD)	패킷이 유효한 DHCPv6 패킷이 아닙니다. 이 테스트는 PxeDhcpv6IsValid 함수에서 사용하는 테스트만큼 철저하지 않습니다. 패킷 길이와 매직 쿠키만 확인됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wdspxe.h
라이브러리	WdsPxe.lib
DLL	WdsPxe.dll

추가 정보

PxeDhcpv6AppendOption

PxeDhcpv6GetVendorOptionValue

PxeDhcpv6IsValid

PxePacketAllocate

Windows Deployment Services 서버 함수