Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
La funzione GetMulticastIpAddressEntry recupera informazioni per una voce di indirizzo IP multicast esistente in un computer locale.
NETIOAPI_API GetMulticastIpAddressEntry(
_Inout_ PMIB_MULTICASTIPADDRESS_ROW Row
);
-
riga [in, out]
Puntatore a una voce di struttura MIB_MULTICASTIPADDRESS_ROW per una voce di indirizzo IP multicast. In caso di esito positivo, questa struttura viene aggiornata con le proprietà per un indirizzo IP multicast esistente.
GetMulticastIpAddressEntry restituisce STATUS_SUCCESS se la funzione ha esito positivo.
Se la funzione non riesce, GetMulticastIpAddressEntry restituisce uno dei codici di errore seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Alla funzione è stato passato un parametro non valido. Questo errore viene restituito se un puntatore NULL viene passato nel parametro Row, Il membro Address della struttura MIB_MULTICASTIPADDRESS_ROW a cui il parametro Row punta non è stato impostato su un indirizzo IPv4 o IPv6 multicast valido oppure entrambi InterfaceLuid e i membri interfaceIndex della struttura MIB_MULTICASTIPADDRESS_ROW non sono stati specificati. |
| STATUS_NOT_FOUND | Impossibile trovare l'interfaccia specificata. Questo errore viene restituito se la funzione non riesce a trovare l'interfaccia di rete specificata dal InterfaceLuid o membro InterfaceIndex della struttura MIB_MULTICASTIPADDRESS_ROW a cui punta il parametro Row. |
| STATUS_NOT_SUPPORTED | La richiesta non è supportata. Questo errore viene restituito se non si trova alcun stack IPv4 nel computer locale e un indirizzo IPv4 è stato specificato nel membro Address della struttura MIB_MULTICASTIPADDRESS_ROW a cui punta il parametro Row o se non si trova alcun stack IPv6 nel computer locale e un indirizzo IPv6 è stato specificato nel membro Address. |
| Altro | Usare la funzione FormatMessage per ottenere la stringa del messaggio per l'errore restituito. |
La funzione GetMulticastIpAddressEntry viene usata per recuperare una voce di struttura MIB_MULTICASTIPADDRESS_ROW esistente.
All'input, il driver deve inizializzare i membri seguenti della struttura MIB_MULTICASTIPADDRESS_ROW a cui punta il parametro Row.
Address
Impostare su un indirizzo e una famiglia IPv4 o IPv6 validi.InterfaceLuid o InterfaceIndex
Questi membri vengono utilizzati nell'ordine elencato in precedenza. Pertanto, se si specifica InterfaceLuid, questo membro viene usato per determinare l'interfaccia. Se non è stato impostato alcun valore per il membro InterfaceLuid (il valore di questo membro è stato impostato su zero), il membro InterfaceIndex viene usato successivamente per determinare l'interfaccia.
Quando la chiamata ha esito positivo, GetMulticastIpAddressEntry recupera le altre proprietà per l'indirizzo IP multicast e compila la struttura MIB_MULTICASTIPADDRESS_ROW a cui punta il parametro Row.
Il driver può chiamare la funzioneGetMulticastIpAddressTableper enumerare le voci di indirizzo IP multicast in un computer locale.
Piattaforma di destinazione |
universale |
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Netioapi.h (include Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |