funzione DnsModifyRecordsInSet_A (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.

Analogamente a molte funzioni DNS, il tipo di funzione DnsModifyRecordsInSet viene implementato in più moduli per facilitare la codifica di caratteri diversi. In base alla codifica dei caratteri coinvolta, 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 RR da aggiungere al set RR.

[in, optional] pDeleteRecords

Puntatore alla struttura DNS_RECORD contenente le RR 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 e,

[in, out, optional] pExtraList

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

[in, out, optional] pReserved

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

Valore restituito

Restituisce la conferma dell'esito positivo al completamento positivo. 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.
I record specificati in pAddRecords vengono aggiunti. Se pAddRecords è vuoto, l'operazione viene completata senza aggiungere record.

Per aggiungere un nuovo record, specificare nessun record in pDeleteRecords e specificare il record da aggiungere in pAddRecords. Per modificare un record, specificare il record modificato 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 o la chiamata avrà esito negativo. Se un record specificato in pAddRecords è già presente, non si verifica alcuna modifica.

Se non viene specificato alcun elenco di server, viene eseguito 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