Función CreateAnycastIpAddressEntry
La función CreateAnycastIpAddressEntry agrega una nueva entrada de dirección IP de anycast en un equipo local.
Sintaxis
NETIOAPI_API CreateAnycastIpAddressEntry(
_In_ const MIB_ANYCASTIPADDRESS_ROW *Row
);
Parámetros
-
fila [in]
Puntero a una entrada de estructura MIB_ANYCASTIPADDRESS_ROW para una entrada de dirección IP de difusión.
Valor devuelto
createAnycastIpAddressEntry devuelve STATUS_SUCCESS si la función se ejecuta correctamente.
Si se produce un error en la función, CreateAnycastIpAddressEntry devuelve uno de los siguientes códigos de error:
| Código devuelto | Descripción |
|---|---|
| STATUS_INVALID_PARAMETER | Se pasó un parámetro no válido a la función . Este error se devuelve si se pasa un puntero null NULL en el parámetro Row, el miembro Address de la estructura de MIB_ANYCASTIPADDRESS_ROW que el parámetro row apunta a no se estableció en una dirección IPv4 o IPv6 válida, o ambos InterfaceLuid y InterfaceIndex miembros de la estructura MIB_ANYCASTIPADDRESS_ROW no se especificaron. |
| STATUS_NOT_FOUND | No se encontró la interfaz especificada. Este error se devuelve si la función no encuentra la interfaz de red especificada por el InterfaceLuid o InterfaceIndex miembro de la estructura de MIB_UNICASTIPADDRESS_ROW a la que apunta el parámetro fila de. |
| STATUS_NOT_SUPPORTED | No se admite la solicitud. Este error se devuelve si no hay ninguna pila IPv4 ubicada en el equipo local y se especificó una dirección IPv4 en el miembro Address de la estructura MIB_ANYCASTIPADDRESS_ROW a la que apunta el parámetro Fila, o si no se encuentra ninguna pila IPv6 en el equipo local y se especificó una dirección IPv6 en el miembro Dirección. |
| ERROR_OBJECT_ALREADY_EXISTS | El objeto ya existe. Este error se devuelve si el miembro address address de la estructura MIB_ANYCASTIPADDRESS_ROW a la que apunta el parámetro row es un duplicado de una dirección IP de difusión existente en la interfaz especificada por el InterfaceLuid o interfaceIndex miembro de la estructura MIB_ANYCASTIPADDRESS_ROW. |
| otros | Use la función FormatMessage para obtener la cadena del mensaje para el error devuelto. |
Observaciones
El controlador debe inicializar los siguientes miembros de la estructura de MIB_ANYCASTIPADDRESS_ROW a los que apunta el parámetro row .
dirección
Establézcalo en una dirección iPv4 o IPv6 válida y una familia.InterfaceLuid o InterfaceIndex
Estos miembros se usan en el orden que se muestra anteriormente. Por lo tanto, si se especifica interfaceLuid, este miembro se usa para determinar la interfaz a la que agregar la dirección IP de unidifusión. Si no se estableció ningún valor para el miembro InterfaceLuid (el valor de este miembro se estableció en cero), el miembro InterfaceIndex se usa a continuación para determinar la interfaz.
El miembro ScopeId de de la estructura MIB_ANYCASTIPADDRESS_ROW a la que apunta el parámetro row se omite cuando se llama a la función createAnycastIpAddressEntry. El miembro ScopeId viene determinado automáticamente por la interfaz en la que se agrega la dirección.
Se produce un error en la función CreateAnycastIpAddressEntry si la dirección IP de anycast que se pasa en el miembro Address de la estructura MIB_ANYCASTIPADDRESS_ROW que apunta el parámetro row es un duplicado de una dirección IP de anycast existente en la interfaz.
Requisitos
Plataforma de destino |
universal |
Versión |
Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Encabezado |
Netioapi.h (incluya Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |