fonction DnsModifyRecordsInSet_A (windns.h)

Article
08/27/2023

La fonction DnsModifyRecordsInSet ajoute, modifie ou supprime un jeu d’enregistrements de ressources (RR) qui a peut-être été précédemment inscrit auprès des serveurs DNS.

Comme de nombreuses fonctions DNS, le type de fonction DnsModifyRecordsInSet est implémenté sous plusieurs formes pour faciliter l’encodage de caractères différents. En fonction de l’encodage de caractères impliqué, utilisez l’une des fonctions suivantes :

DnsModifyRecordsInSet_A (_A pour l’encodage ANSI)
DnsModifyRecordsInSet_W (_W pour l’encodage Unicode)
DnsModifyRecordsInSet_UTF8 (_UTF8 pour l’encodage UTF 8)

Syntaxe

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
);

Paramètres

[in, optional] pAddRecords

Pointeur vers la structure DNS_RECORD qui contient les RR à ajouter au jeu RR.

[in, optional] pDeleteRecords

Pointeur vers la structure DNS_RECORD qui contient les RR à supprimer du jeu RR.

[in] Options

Valeur qui contient une bitmap des options de mise à jour DNS. Les options peuvent être combinées et toutes les options remplacent DNS_UPDATE_SECURITY_USE_DEFAULT.

[in, optional] hCredentials

Handle pour les informations d’identification d’un compte spécifique. Utilisé lorsque la mise à jour dynamique sécurisée est requise. Ce paramètre est facultatif.

[in, out, optional] pExtraList

Ce paramètre est réservé à une utilisation ultérieure et doit être défini sur NULL.

[in, out, optional] pReserved

Ce paramètre est réservé à une utilisation ultérieure et doit être défini sur NULL.

Valeur retournée

Retourne la confirmation de réussite en cas d’achèvement réussi. Sinon, il retourne le code d’erreur dns approprié tel que défini dans Winerror.h.

Remarques

Le type de fonction DnsModifyRecordsInSet s’exécute dans les étapes suivantes.

Les enregistrements spécifiés dans pDeleteRecords sont supprimés . Si pDeleteRecords est vide ou ne contient pas d’enregistrements qui existent dans l’ensemble actif, la fonction DnsModifyRecordsInSet passe à l’étape suivante.
Les enregistrements spécifiés dans pAddRecords sont ajoutés . Si pAddRecords est vide, l’opération se termine sans ajouter d’enregistrements.

Pour ajouter un nouvel enregistrement, ne fournissez aucun enregistrement dans pDeleteRecords et fournissez l’enregistrement à ajouter dans pAddRecords. Pour modifier un enregistrement, spécifiez l’enregistrement en cours de modification dans pDeleteRecords, puis ajoutez la version modifiée de cet enregistrement en le plaçant dans pAddRecords. Pour supprimer des enregistrements, spécifiez uniquement les enregistrements à supprimer. Plusieurs enregistrements peuvent être ajoutés ou supprimés en un seul appel à DnsModifyRecordsInSet ; toutefois, la valeur du membre pName dans chaque DNS_RECORD doit être la même, sinon l’appel échoue. Si un enregistrement spécifié dans pAddRecords est déjà présent, aucune modification ne se produit.

Si aucune liste de serveurs n’est spécifiée, le serveur de noms par défaut est interrogé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	windns.h
Bibliothèque	Dnsapi.lib
DLL	Dnsapi.dll

Voir aussi

DNS_RECORD

DnsQuery

DnsReplaceRecordSet

Partager via