Funzione CreateAnycastIpAddressEntry
La funzione CreateAnycastIpAddressEntry aggiunge una nuova voce di indirizzo IP anycast in un computer locale.
Sintassi
NETIOAPI_API CreateAnycastIpAddressEntry(
_In_ const MIB_ANYCASTIPADDRESS_ROW *Row
);
Parametri
- Riga [in]
Puntatore a una voce di struttura MIB_ANYCASTIPADDRESS_ROW per una voce di indirizzo IP anycast.
Valore restituito
CreateAnycastIpAddressEntry restituisce STATUS_SUCCESS se la funzione ha esito positivo.
Se la funzione ha esito negativo, CreateAnycastIpAddressEntry 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_UNICASTIPADDRESS_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_ANYCASTIPADDRESS_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. |
| ERROR_OBJECT_ALREADY_EXISTS | L'oggetto esiste già. Questo errore viene restituito se il membro Address della struttura MIB_ANYCASTIPADDRESS_ROW a cui punta il parametro Row è un duplicato di un indirizzo IP anycast esistente nell'interfaccia specificata dal membro InterfaceLuid o InterfaceIndex della struttura MIB_ANYCASTIPADDRESS_ROW. |
| Altri | Utilizzare la funzione FormatMessage per ottenere la stringa di messaggio per l'errore restituito. |
Commenti
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 IPv4 o IPv6 unicast 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 a cui aggiungere l'indirizzo IP unicast. 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.
Il membro ScopeId della struttura MIB_ANYCASTIPADDRESS_ROW a cui punta il parametro Row viene ignorato quando viene chiamata la funzione CreateAnycastIpAddressEntry . Il membro ScopeId viene determinato automaticamente dall'interfaccia in cui viene aggiunto l'indirizzo.
La funzione CreateAnycastIpAddressEntry ha esito negativo se l'indirizzo IP anycast passato nel membro Address della struttura MIB_ANYCASTIPADDRESS_ROW a cui punta il parametro Row è un duplicato di un indirizzo IP anycast esistente nell'interfaccia.
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 |