Funzione GetAnycastIpAddressEntry (netioapi.h)
La funzione GetAnycastIpAddressEntry recupera informazioni per una voce di indirizzo IP anycast esistente nel computer locale.
Sintassi
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetAnycastIpAddressEntry(
[in, out] PMIB_ANYCASTIPADDRESS_ROW Row
);
Parametri
[in, out] Row
Puntatore a una voce di struttura MIB_ANYCASTIPADDRESS_ROW per una voce di indirizzo IP anycast. In caso di esito positivo, questa struttura verrà aggiornata con le proprietà per un indirizzo IP anycast esistente.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Non è possibile trovare il file specificato. Questo errore viene restituito se l'interfaccia di rete LUID o l'indice di interfaccia specificato dal membro InterfaceLuid o InterfaceIndex del MIB_ANYCASTIPADDRESS_ROW a cui punta il parametro Row non è un valore nel computer locale. |
|
Un parametro non è corretto. Questo errore viene restituito se un puntatore NULL viene passato nel parametro Row , il membro Address del MIB_ANYCASTIPADDRESS_ROW a cui punta il parametro Row non è impostato su un indirizzo IPv4 o IPv6 valido oppure entrambi i membri InterfaceLuid o InterfaceIndex del MIB_ANYCASTIPADDRESS_ROW a cui punta il parametro Row non sono stati specificati. |
|
Element not found. Questo errore viene restituito se l'interfaccia di rete specificata dal membro InterfaceLuid o InterfaceIndex della struttura MIB_ANYCASTIPADDRESS_ROW a cui punta il parametro Row non corrisponde all'indirizzo IP e alla famiglia di indirizzi specificata nel membro Address nella struttura MIB_ANYCASTIPADDRESS_ROW . |
|
La richiesta non è supportata. Questo errore viene restituito se non si trova alcun stack IPv4 nel computer locale e viene specificato un indirizzo IPv4 nel membro Address della struttura MIB_UNICASTIPADDRESS_ROW a cui punta il parametro Row . Questo errore viene restituito se non si trova alcun stack IPv6 nel computer locale e nel membro Address viene specificato un indirizzo IPv6. |
|
Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito. |
Commenti
La funzione GetAnycastIpAddressEntry viene definita in Windows Vista e versioni successive.
La funzione GetAnycastIpAddressEntry viene usata per recuperare una voce di struttura MIB_ANYCASTIPADDRESS_ROW esistente.
All'input, il membro Address nella struttura MIB_ANYCASTIPADDRESS_ROW a cui punta il parametro Row deve essere inizializzato in un indirizzo e una famiglia IPv6 IPv4 o IPv6 validi. Inoltre, almeno uno dei membri seguenti nella struttura MIB_ANYCASTIPADDRESS_ROW a cui punta il parametro Row deve essere inizializzato: InterfaceLuid o InterfaceIndex.
I campi vengono usati nell'ordine indicato in precedenza. Quindi, se si specifica InterfaceLuid , questo membro viene usato per determinare l'interfaccia. Se non viene impostato alcun valore per il membro InterfaceLuid (il valore di questo membro è impostato su zero), il membro InterfaceIndex viene usato successivamente per determinare l'interfaccia.
Quando la chiamata ha esito positivo, GetAnycastIpAddressEntry recupera le altre proprietà per l'indirizzo IP anycast e compila la struttura MIB_ANYCASTIPADDRESS_ROW a cui punta il parametro Row .
È possibile chiamare la funzione GetAnycastIpAddressTable per enumerare le voci di indirizzo IP anycast in un computer locale.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | netioapi.h (include Iphlpapi.h) |
| Libreria | Iphlpapi.lib |
| DLL | Iphlpapi.dll |