CreateAnycastIpAddressEntry 函式
CreateAnycastIpAddressEntry函式會在本機電腦上新增任何傳送 IP 位址專案。
語法
NETIOAPI_API CreateAnycastIpAddressEntry(
_In_ const MIB_ANYCASTIPADDRESS_ROW *Row
);
參數
- 資料列 [in]
任何傳播 IP 位址專案的 MIB_ANYCASTIPADDRESS_ROW 結構專案的指標。
傳回值
如果函式成功，CreateAnycastIpAddressEntry會傳回STATUS_SUCCESS。
如果函式失敗， CreateAnycastIpAddressEntry 會傳回下列其中一個錯誤碼：
| 傳回碼 | 描述 |
|---|---|
| STATUS_INVALID_PARAMETER | 不正確參數已傳遞至 函式。 如果在Row參數中傳遞Null指標、Row參數指向的 MIB_ANYCASTIPADDRESS_ROW結構的Address成員未設定為有效的單播 IPv4 或 IPv6 位址，或是未指定 MIB_ANYCASTIPADDRESS_ROW 結構的InterfaceLuid和InterfaceIndex成員，就會傳回此錯誤。 |
| STATUS_NOT_FOUND | 找不到指定的介面。 如果函式找不到Row參數所指向之 MIB_UNICASTIPADDRESS_ROW 結構的InterfaceLuid或InterfaceIndex成員所指定的網路介面，就會傳回此錯誤。 |
| STATUS_NOT_SUPPORTED | 不支援此要求。 如果本機電腦上沒有 IPv4 堆疊，而且在Row參數指向之MIB_ANYCASTIPADDRESS_ROW結構的Address成員中指定了 IPv4 位址，或如果本機電腦上沒有 IPv6 堆疊，而且在 Address成員中指定了 IPv6 位址，則會傳回此錯誤。 |
| ERROR_OBJECT_ALREADY_EXISTS | 物件已存在。 如果Row參數指向之MIB_ANYCASTIPADDRESS_ROW結構的Address成員是介面上由 MIB_ANYCASTIPADDRESS_ROW 結構的InterfaceLuid或InterfaceIndex成員所指定的現有任何傳播 IP 位址重複，就會傳回此錯誤。 |
| 其他 | 使用 FormatMessage 函式來取得傳回錯誤的訊息字串。 |
備註
驅動程式必須初始化Row參數所指向MIB_ANYCASTIPADDRESS_ROW結構的下列成員。
位址
設定為有效的單播 IPv4 或 IPv6 位址和系列。InterfaceLuid 或 InterfaceIndex
這些成員會依照稍早所列的順序使用。 因此，如果指定 InterfaceLuid ，則會使用此成員來判斷要新增單播 IP 位址的介面。 如果未為 InterfaceLuid 成員設定任何值， (這個成員的值設定為零) ，則接著會使用 InterfaceIndex 成員來判斷介面。
呼叫CreateAnycastIpAddressEntry函式時，會忽略Row參數指向的 MIB_ANYCASTIPADDRESS_ROW 結構ScopeId成員。 ScopeId成員會自動由新增位址的介面決定。
如果傳入 Row 參數所指向之 MIB_ANYCASTIPADDRESS_ROW 結構的Address成員中的任何傳播 IP 位址，則CreateAnycastIpAddressEntry函式會失敗。
規格需求
目標平台 |
普遍 |
版本 |
可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
標頭 |
Netioapi.h (包含 Netioapi.h) |
程式庫 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |