Metodo SetDNSSuffixSearchOrder della classe Win32_NetworkAdapterConfiguration

Il metodo statico della classe WMI SetDNSSuffixSearchOrderusa una matrice di elementi stringa per impostare l'ordine di ricerca del suffisso.

In questo argomento viene utilizzata la sintassi MOF (Managed Object Format). Per altre informazioni sull'uso di questo metodo, vedere Chiamata di un metodo.

Sintassi

uint32 SetDNSSuffixSearchOrder(
  [in] string DNSDomainSuffixSearchOrder[]
);

Parametri

DNSDomainSuffixSearchOrder [in]

Elenco di suffissi del server per eseguire query per i server DNS. Il percorso del Registro di sistema del suffisso DNS è HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Tcpip|NameServer

Esempio: "suffix1.company.com", "suffix2.company.com"

Valore restituito

Restituisce un valore pari a 0 (zero) per un completamento riuscito quando non è necessario alcun riavvio, 1 (uno) per un completamento corretto quando è necessario un riavvio e un numero diverso se si verifica un errore. Per altre informazioni sui codici di errore, vedere Costanti errore WMI o WbemErrorEnum. Per i valori HRESULT generali, vedere Codici di errore di sistema.

Completamento completato, nessun riavvio necessario

0

Completamento completato, nessun riavvio necessario.

Completamento completato, riavvio richiesto

1

Completamento completato, riavvio richiesto.

Metodo non supportato in questa piattaforma

64

Metodo non supportato in questa piattaforma.

Errore sconosciuto

65

Errore sconosciuto.

Subnet mask non valida

66

Subnet mask non valida.

Errore durante l'elaborazione di un'istanza restituita

67

Errore durante l'elaborazione di un'istanza restituita.

Parametro di input non valido

68

Parametro di input non valido.

Più di 5 gateway specificati

69

Più di cinque gateway specificati.

Indirizzo IP non valido

70

Indirizzo IP non valido.

Indirizzo IP del gateway non valido

71

Indirizzo IP del gateway non valido.

Errore durante l'accesso al Registro di sistema per le informazioni richieste

72

Errore durante l'accesso al Registro di sistema per le informazioni richieste.

Nome di dominio non valido

73

Nome di dominio non valido.

Nome host non valido

74

Nome host non valido.

Nessun server WINS primario/secondario definito

75

Nessun server WINS primario o secondario definito.

File non valido

76

File non valido.

Percorso di sistema non valido

77

Percorso di sistema non valido.

Copia file non riuscita

78

Copia file non riuscita.

Parametro di sicurezza non valido

79

Parametro di sicurezza non valido.

Impossibile configurare il servizio TCP/IP

80

Impossibile configurare il servizio TCP/IP.

Impossibile configurare il servizio DHCP

81

Impossibile configurare il servizio DHCP.

Non è possibile rinnovare il lease DHCP

82

Impossibile rinnovare il lease DHCP.

Non è possibile rilasciare il lease DHCP

83

Impossibile rilasciare il lease DHCP.

IP non abilitato nell'adapter

84

IP non abilitato nella scheda.

IPX non abilitato nella scheda

85

IPX non abilitato nella scheda.

Errore di limiti di frame/numero di rete

86

Errore di limiti di frame o numero di rete.

Tipo di frame non valido

87

Tipo di frame non valido.

Numero di rete non valido

88

Numero di rete non valido.

Numero di rete duplicato

89

Numero di rete duplicato.

Parametro fuori dai limiti

90

Parametro fuori dai limiti.

Accesso negato

91

Accesso negato.

Memoria insufficiente

92

Memoria esaurita.

Esiste già

93

Esiste già.

Percorso, file o oggetto non trovato

94

Percorso, file o oggetto non trovato.

Impossibile inviare una notifica al servizio

95

Impossibile inviare una notifica al servizio.

Impossibile inviare una notifica al servizio DNS

96

Impossibile inviare una notifica al servizio DNS.

Interfaccia non configurabile

97

Interfaccia non configurabile.

Non tutti i lease DHCP potrebbero essere rilasciati/rinnovati

98

Non tutti i lease DHCP vengono rilasciati o rinnovati.

DHCP non abilitato per l'adapter

100

DHCP non abilitato nella scheda.

Altri

101 4294967295

Osservazioni:

Si tratta di una chiamata indipendente dall'istanza che si applica a tutte le schede, ma solo per Windows.

Esempi

Il codice di PowerShell seguente imposta l'ordine di ricerca del suffisso DNS.

#First store the suffixes to set in a variable
$suffixes = 'microsoft.com', 'google.com', 'yahoo.com'

#Since this is a static method, get a class object and then call the method. 
$class = [wmiclass]'Win32_NetworkAdapterConfiguration'
$class.SetDNSSuffixSearchOrder($suffixes)

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista
Server minimo supportato
Windows Server 2008
Spazio dei nomi
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Vedi anche

Classi hardware del sistema informatico

Win32_NetworkAdapterConfiguration

Attività WMI: Rete

Attività WMI: account e domini

Supporto IPv6 e IPv4 in WMI