Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La función GetMulticastIpAddressEntry recupera información de una entrada de dirección IP de multidifusión existente en un equipo local.
Sintaxis
NETIOAPI_API GetMulticastIpAddressEntry(
_Inout_ PMIB_MULTICASTIPADDRESS_ROW Row
);
Parámetros
-
fila [in, out]
Puntero a una entrada de estructura de MIB_MULTICASTIPADDRESS_ROW para una entrada de dirección IP de multidifusión. Si la devolución es correcta, esta estructura se actualiza con las propiedades de una dirección IP de multidifusión existente.
Valor devuelto
getMulticastIpAddressEntry devuelve STATUS_SUCCESS si la función se realiza correctamente.
Si se produce un error en la función, GetMulticastIpAddressEntry 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 Row, el miembro Address de la estructura MIB_MULTICASTIPADDRESS_ROW que el parámetro Row de apunta a no se estableció en una dirección IPv4 o IPv6 válida, o ambos InterfaceLuid y InterfaceIndex miembros de la estructura MIB_MULTICASTIPADDRESS_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_MULTICASTIPADDRESS_ROW a la que apunta el parámetro Row . |
| 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 del MIB_MULTICASTIPADDRESS_ROW estructura a la que apunta el parámetro Row, o si no se encuentra ninguna pila IPv6 en el equipo local y se especificó una dirección IPv6 en el miembro Dirección. |
| otros | Use la función FormatMessage para obtener la cadena del mensaje para el error devuelto. |
Observaciones
La función getMulticastIpAddressEntry se usa para recuperar una entrada de estructura de MIB_MULTICASTIPADDRESS_ROW existente.
En la entrada, el controlador debe inicializar los siguientes miembros de la estructura MIB_MULTICASTIPADDRESS_ROW a la que apunta el parámetro row .
dirección
Establézcalo en una dirección y familia IPv4 o IPv6 válidas.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. 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.
Cuando la llamada se realiza correctamente, GetMulticastIpAddressEntry recupera las demás propiedades de la dirección IP de multidifusión y rellena la estructura MIB_MULTICASTIPADDRESS_ROW a la que apunta el parámetro Row .
El controlador puede llamar a la funciónGetMulticastIpAddressTable para enumerar las entradas de dirección IP de multidifusión en un equipo local.
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 |