funzione DnsModifyRecordsInSet_W (windns.h)

Articolo
03/13/2024

La funzione DnsModifyRecordsInSet aggiunge, modifica o rimuove un set di record di risorse (RR) che potrebbe essere stato registrato in precedenza con i server DNS.

Come molte funzioni DNS, il tipo di funzione DnsModifyRecordsInSet viene implementato in più moduli per facilitare la codifica dei caratteri diversa. In base alla codifica dei caratteri interessata, usare una delle funzioni seguenti:

DnsModifyRecordsInSet_A (_A per la codifica ANSI)
DnsModifyRecordsInSet_W (_W per la codifica Unicode)
DnsModifyRecordsInSet_UTF8 (_UTF8 per la codifica UTF 8)

Sintassi

DNS_STATUS DnsModifyRecordsInSet_W(
  [in, optional]      PDNS_RECORD pAddRecords,
  [in, optional]      PDNS_RECORD pDeleteRecords,
  [in]                DWORD       Options,
  [in, optional]      HANDLE      hCredentials,
  [in, out, optional] PVOID       pExtraList,
  [in, out, optional] PVOID       pReserved
);

Parametri

[in, optional] pAddRecords

Puntatore alla struttura DNS_RECORD che contiene le richieste pull da aggiungere al set RR.

[in, optional] pDeleteRecords

Puntatore alla struttura DNS_RECORD che contiene le richieste pull da eliminare dal set RR.

[in] Options

Valore che contiene una bitmap delle opzioni di aggiornamento DNS. Le opzioni possono essere combinate e tutte le opzioni sostituiscono DNS_UPDATE_SECURITY_USE_DEFAULT.

[in, optional] hCredentials

Handle per le credenziali di un account specifico. Usato quando è necessario un aggiornamento dinamico sicuro. Questo parametro è facoltativo e,

[in, out, optional] pExtraList

Questo parametro è riservato per uso futuro e deve essere impostato su NULL.

[in, out, optional] pReserved

Questo parametro è riservato per uso futuro e deve essere impostato su NULL.

Valore restituito

Restituisce la conferma dell'esito positivo al completamento. In caso contrario, restituisce il codice di errore specifico del DNS appropriato, come definito in Winerror.h.

Commenti

Il tipo di funzione DnsModifyRecordsInSet viene eseguito nei passaggi seguenti.

I record specificati in pDeleteRecords vengono eliminati. Se pDeleteRecords è vuoto o non contiene record presenti nel set corrente, la funzione DnsModifyRecordsInSet passa al passaggio successivo.
Vengono aggiunti record specificati in pAddRecords . Se pAddRecords è vuoto, l'operazione viene completata senza aggiungere record.

Per aggiungere un nuovo record, non specificare alcun record in pDeleteRecords e specificare il record da aggiungere in pAddRecords. Per modificare un record, specificare il record da modificare in pDeleteRecords, quindi aggiungere la versione modificata del record inserendola in pAddRecords. Per eliminare i record, specificare solo i record da eliminare. È possibile aggiungere o eliminare più record in una singola chiamata a DnsModifyRecordsInSet; Tuttavia, il valore del membro pName in ogni DNS_RECORD deve essere uguale o la chiamata avrà esito negativo. Se è già presente un record specificato in pAddRecords , non viene apportata alcuna modifica.

Se non viene specificato alcun elenco di server, viene eseguita una query sul server dei nomi predefinito.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	windns.h
Libreria	Dnsapi.lib
DLL	Dnsapi.dll

Vedi anche

DNS_RECORD

DnsQuery

DnsReplaceRecordSet

Condividi tramite