Compartir a través de

función DnsModifyRecordsInSet_A (windns.h)

  • Artículo

La función DnsModifyRecordsInSet agrega, modifica o quita un conjunto de registros de recursos (RR) que se puede haber registrado previamente con servidores DNS.

Al igual que muchas funciones DNS, el tipo de función DnsModifyRecordsInSet se implementa en varios formularios para facilitar la codificación de caracteres diferente. En función de la codificación de caracteres implicada, use una de las siguientes funciones:

  • DnsModifyRecordsInSet_A (_A para la codificación ANSI)
  • DnsModifyRecordsInSet_W (_W para la codificación Unicode)
  • DnsModifyRecordsInSet_UTF8 (_UTF8 para codificación UTF 8)

Sintaxis

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

Parámetros

[in, optional] pAddRecords

Puntero a la estructura DNS_RECORD que contiene las RR que se van a agregar al conjunto rr.

[in, optional] pDeleteRecords

Puntero a la estructura DNS_RECORD que contiene las RR que se van a eliminar del conjunto rr.

[in] Options

Valor que contiene un mapa de bits de las opciones de actualización de DNS. Las opciones se pueden combinar y todas las opciones invalidan DNS_UPDATE_SECURITY_USE_DEFAULT.

[in, optional] hCredentials

Identificador de las credenciales de una cuenta específica. Se usa cuando se requiere una actualización dinámica segura. Este parámetro es opcional.

[in, out, optional] pExtraList

Este parámetro está reservado para uso futuro y debe establecerse en NULL.

[in, out, optional] pReserved

Este parámetro está reservado para uso futuro y debe establecerse en NULL.

Valor devuelto

Devuelve la confirmación correcta tras la finalización correcta. De lo contrario, devuelve el código de error específico de DNS adecuado tal como se define en Winerror.h.

Comentarios

El tipo de función DnsModifyRecordsInSet se ejecuta en los pasos siguientes.

  1. Se eliminan los registros especificados en pDeleteRecords . Si pDeleteRecords está vacío o no contiene registros que existen en el conjunto actual, la función DnsModifyRecordsInSet va al paso siguiente.
  2. Se agregan registros especificados en pAddRecords . Si pAddRecords está vacío, la operación se completa sin agregar ningún registro.
Para agregar un nuevo registro, proporcione ningún registro en pDeleteRecords y proporcione el registro que se va a agregar en pAddRecords. Para modificar un registro, especifique el registro que se va a modificar en pDeleteRecords y agregue la versión modificada de ese registro colocándolo en pAddRecords. Para eliminar registros, especifique solo los registros que se van a eliminar. Se pueden agregar o eliminar varios registros en una sola llamada a DnsModifyRecordsInSet; sin embargo, el valor del miembro pName en cada DNS_RECORD debe ser el mismo o se producirá un error en la llamada. Si ya hay un registro especificado en pAddRecords , no se produce ningún cambio.

Si no se especifica ninguna lista de servidores, se consulta el servidor de nombres predeterminado.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado windns.h
Library Dnsapi.lib
Archivo DLL Dnsapi.dll

Consulte también

DNS_RECORD

DnsQuery

DnsReplaceRecordSet