funzione DnsModifyRecordsInSet_A (windns.h)

Articolo
01/16/2025

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.

Analogamente a molte funzioni DNS, il DnsModifyRecordsInSet tipo di funzione viene implementato in più forme 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_A(
  [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 di 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.

[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.

Osservazioni

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, specificare nessun record in pDeleteRecordse 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 lo stesso oppure la chiamata avrà esito negativo. Se un record specificato in pAddRecords è già presente, non viene apportata alcuna modifica.

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

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	windns.h
libreria	Dnsapi.lib
dll	Dnsapi.dll

Vedere anche

DNS_RECORD

DnsQuery

DnsReplaceRecordSet

Condividi tramite