SetUnicastIpAddressEntry 함수
SetUnicastIpAddressEntry 함수는 로컬 컴퓨터에서 기존 유니캐스트 IP 주소 항목의 속성을 설정합니다.
구문
NETIOAPI_API SetUnicastIpAddressEntry(
_In_ const MIB_UNICASTIPADDRESS_ROW *Row
);
매개 변수
- 행 [in]
기존 유니캐스트 IP 주소 항목에 대한 MIB_UNICASTIPADDRESS_ROW 구조체 항목에 대한 포인터입니다.
반환 값
SetUnicastIpAddressEntry 는 함수가 성공하면 STATUS_SUCCESS 반환합니다.
함수가 실패하면 SetUnicastIpAddressEntry 는 다음 오류 코드 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_INVALID_PARAMETER | 잘못된 매개 변수가 함수에 전달되었습니다. 이 오류는 Row 매개 변수에 NULL 포인터가 전달되거나 Row 매개 변수가 가리키는 MIB_UNICASTIPADDRESS_ROW 구조체의 Address 멤버가 유효한 유니캐스트 IPv4 또는 IPv6 주소로 설정되지 않았거나 MIB_UNICASTIPADDRESS_ROW 구조체의 InterfaceLuid 및 InterfaceIndex 멤버가 모두 지정되지 않은 경우 반환됩니다. |
| STATUS_NOT_FOUND | 지정된 인터페이스를 찾을 수 없습니다. 이 오류는 함수가 Row 매개 변수가 가리키는 MIB_UNICASTIPADDRESS_ROW 구조체의 InterfaceLuid 또는 InterfaceIndex 멤버에 의해 지정된 네트워크 인터페이스를 찾을 수 없는 경우 반환됩니다. |
| STATUS_NOT_SUPPORTED | 요청이 지원되지 않습니다. 이 오류는 로컬 컴퓨터에 IPv4 스택이 없고 Row 매개 변수가 가리키는 MIB_UNICASTIPADDRESS_ROW 구조의 Address 멤버에 IPv4 주소가 지정되었거나 로컬 컴퓨터에 IPv6 스택이 없고 주소 멤버에 IPv6 주소가 지정된 경우 반환됩니다. |
| 기타 | FormatMessage 함수를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다. |
설명
GetUnicastIpAddressEntry 함수는 일반적으로 수정할 기존 MIB_UNICASTIPADDRESS_ROW 구조체 항목을 검색하는 데 사용됩니다. 그런 다음 드라이버는 수정하려는 MIB_UNICASTIPADDRESS_ROW 항목의 멤버를 변경한 다음 SetUnicastIpAddressEntry 함수를 호출할 수 있습니다.
드라이버는 InitializeUnicastIpAddressEntry 함수를 호출하여 변경하기 전에 기본값으로 MIB_UNICASTIPADDRESS_ROW 구조체 항목의 멤버를 초기화할 수 있습니다. 그러나 드라이버는 일반적으로 InitializeUnicastIpAddressEntry를 호출하기 전에 InterfaceLuid 또는 InterfaceIndex 멤버를 저장하고 호출 후 이러한 멤버 중 하나를 복원합니다.
드라이버는 Row 매개 변수가 가리키는 MIB_UNICASTIPADDRESS_ROW 구조체의 다음 멤버를 초기화해야 합니다.
주소
유효한 유니캐스트 IPv4 또는 IPv6 주소 및 패밀리로 설정합니다.InterfaceLuid 또는 InterfaceIndex
이러한 멤버는 이전에 나열된 순서대로 사용됩니다. 따라서 InterfaceLuid 를 지정하면 이 멤버를 사용하여 인터페이스를 확인합니다. InterfaceLuid 멤버에 대해 값이 설정되지 않은 경우(이 멤버의 값이 0으로 설정된 경우) InterfaceIndex 멤버가 인터페이스를 확인하는 데 다음에 사용됩니다.
Row 매개 변수가 가리키는 MIB_UNICASTIPADDRESS_ROW 구조체의 OnLinkPrefixLength 멤버가 255로 설정된 경우 SetUnicastIpAddressEntry는 OnLinkPrefixLength 멤버가 IP 주소의 길이와 같도록 유니캐스트 IP 주소 속성을 설정합니다. 유니캐스트 IPv4 주소의 경우 OnLinkPrefixLength 는 32로 설정됩니다. 유니캐스트 IPv6 주소의 경우 OnLinkPrefixLength 는 128로 설정됩니다. 이러한 설정으로 인해 IPv4 주소의 서브넷 마스크가 잘못되거나 IPv6 주소에 대한 잘못된 링크 접두사가 발생하는 경우 드라이버는 SetUnicastIpAddressEntry를 호출하기 전에 이 멤버를 올바른 값으로 설정해야 합니다.
SetUnicastIpAddressEntry는 Row 매개 변수가 가리키는 MIB_UNICASTIPADDRESS_ROW 구조체의 DadState, ScopeId 및 CreationTimeStamp 멤버를 무시합니다. 이러한 멤버는 네트워크 스택에 의해 설정되며 SetUnicastIpAddressEntry 함수를 사용하여 변경할 수 없습니다. ScopeId 멤버는 주소가 추가된 인터페이스에 의해 자동으로 결정됩니다.
요구 사항
대상 플랫폼 |
유니버설 |
버전 |
Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
헤더 |
Netioapi.h(Netioapi.h 포함) |
라이브러리 |
Netio.lib |
Irql |
< DISPATCH_LEVEL |