fonction DnsModifyRecordsInSet_A (windns.h)

Article
01/16/2025

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

Comme de nombreuses fonctions DNS, le type de fonction DnsModifyRecordsInSet est implémenté dans plusieurs formulaires pour faciliter l’encodage de caractères différent. 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 d'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é pour une utilisation ultérieure et doit être défini sur NULL.

[in, out, optional] pReserved

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

Valeur de retour

Retourne la confirmation de réussite lors de la réussite. Dans le cas contraire, elle retourne le code d’erreur propre au 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 le jeu actuel, 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 pDeleteRecordset indiquez 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 dans un seul appel à DnsModifyRecordsInSet; Toutefois, la valeur du membre pName de dans chaque DNS_RECORD doit être identique ou 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é.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	windns.h
bibliothèque	Dnsapi.lib
DLL	Dnsapi.dll

Voir aussi

DNS_RECORD

DnsQuery

dnsReplaceRecordSet

Partager via