Funzione GetAnycastIpAddressEntry
La funzione GetAnycastIpAddressEntry recupera informazioni per una voce di indirizzo IP anycast esistente in un computer locale.
Sintassi
NETIOAPI_API GetAnycastIpAddressEntry(
_Inout_ PMIB_ANYCASTIPADDRESS_ROW Row
);
Parametri
- Riga [in, out]
Puntatore a una voce di struttura MIB_ANYCASTIPADDRESS_ROW per una voce di indirizzo IP anycast. In caso di esito positivo, questa struttura viene aggiornata con le proprietà per un indirizzo IP anycast esistente.
Valore restituito
GetAnycastIpAddressEntry restituisce STATUS_SUCCESS se la funzione ha esito positivo.
Se la funzione ha esito negativo, GetAnycastIpAddressEntry 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_ANYCASTIPADDRESS_ROW a cui punta il parametro Row non è stato impostato su un indirizzo IPv4 o IPv6 valido oppure i membri InterfaceLuid e InterfaceIndex della struttura MIB_ANYCASTIPADDRESS_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 membro InterfaceLuid o InterfaceIndex della struttura MIB_ANYCASTIPADDRESS_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_UNICASTIPADDRESS_ROW a cui punta il parametro Row oppure se non si trova alcun stack IPv6 nel computer locale e nel membro Address è stato specificato un indirizzo IPv6. |
| Altri | Utilizzare la funzione FormatMessage per ottenere la stringa di messaggio per l'errore restituito. |
Commenti
La funzione GetAnycastIpAddressEntry viene usata per recuperare una voce di struttura MIB_ANYCASTIPADDRESS_ROW esistente.
In input, il driver deve inizializzare i membri seguenti della struttura MIB_ANYCASTIPADDRESS_ROW a cui punta il parametro Row .
Indirizzo
Impostare su un indirizzo e una famiglia anycast IPv4 o IPv6 validi.InterfaceLuid o InterfaceIndex
Questi membri vengono usati nell'ordine elencato in precedenza. Se quindi 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.
In caso di esito positivo della chiamata, GetAnycastIpAddressEntry recupera le altre proprietà per l'indirizzo IP anycast e compila la struttura MIB_ANYCASTIPADDRESS_ROW a cui punta il parametro Row .
Il driver può chiamare la funzione GetAnycastIpAddressTable per enumerare le voci di indirizzo IP anycast in un computer locale.
Requisiti
Piattaforma di destinazione |
Universale |
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Netioapi.h (include Netioapi.h) |
Libreria |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |