InitializeUnicastIpAddressEntry 함수

아티클
03/08/2023

InitializeUnicastIpAddressEntry 함수는 로컬 컴퓨터의 유니캐스트 IP 주소 항목에 대한 기본값을 사용하여 MIB_UNICASTIPADDRESS_ROW 구조를 초기화합니다.

구문

VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
  _Out_ PMIB_UNICASTIPADDRESS_ROW Row
);

매개 변수

행 [out]
항목에서 유니캐스트 IP 주소 항목에 대한 MIB_UNICASTIPADDRESS_ROW 구조 항목에 대한 포인터입니다. 반환 시 이 매개 변수가 가리키는 MIB_UNICASTIPADDRESS_ROW 구조체가 유니캐스트 IP 주소의 기본값으로 초기화됩니다.

반환 값

없음

설명

드라이버는 InitializeUnicastIpAddressEntry 함수를 사용하여 나중에 CreateUnicastIpAddressEntry 함수에 사용할 유니캐스트 IP 주소의 기본값을 사용하여 MIB_UNICASTIPADDRESS_ROW 구조체 항목의 멤버를 초기화해야 합니다.

입력 시 드라이버는 초기화할 새 MIB_UNICASTIPADDRESS_ROW 구조체 InitializeUnicastIpAddressEntry 를 전달해야 합니다.

출력에서 Row 매개 변수가 가리키는 MIB_UNICASTIPADDRESS_ROW 구조체의 멤버는 다음과 같이 초기화됩니다.

PrefixOrigin
NL_PREFIX_ORIGIN 열거형의 IpPrefixOriginUnchanged 값으로 설정합니다.
SuffixOrigin
NL_PREFIX_ORIGIN 열거형의 IpSuffixOriginUnchanged 값으로 설정합니다.
OnLinkPrefixLength
잘못된 값으로 설정합니다.
PreferredLifetime 및 ValidLifetime
무한 값으로 설정합니다.
SkipAsSource
FALSE로 설정합니다.
다른 모든 멤버
0으로 설정됩니다.

드라이버가 InitializeUnicastIpAddressEntry를 호출한 후 드라이버는 수정하려는 MIB_UNICASTIPADDRESS_ROW 항목의 멤버를 변경한 다음 CreateUnicastIpAddressEntry 를 호출하여 새 유니캐스트 IP 주소를 로컬 컴퓨터에 추가할 수 있습니다.

요구 사항

대상 플랫폼	유니버설
버전	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
헤더	Netioapi.h(Netioapi.h 포함)
라이브러리	Netio.lib
Irql	< DISPATCH_LEVEL