Función DnsReplaceRecordSetA (windns.h)

El tipo de función DnsReplaceRecordSet reemplaza a un conjunto de registros de recursos (RR) existente. Al igual que muchas funciones DNS, el tipo de función DnsReplaceRecordSet se implementa en varios formularios para facilitar la codificación de caracteres diferente, que se indica mediante un sufijo. En función de la codificación de caracteres implicada, use una de las siguientes funciones:

DnsReplaceRecordSetA (_A para la codificación ANSI)

DnsReplaceRecordSetW (_W para la codificación Unicode)

DnsReplaceRecordSetUTF8 (_UTF8 para la codificación UTF 8)

Tenga en cuenta la falta de un carácter de subrayado entre el nombre del tipo de función y su sufijo. Si se llama al tipo de función DnsReplaceRecordSet sin su sufijo (A, W o UTF8), se producirá un error del compilador.

Sintaxis

DNS_STATUS DnsReplaceRecordSetA(
  [in]                PDNS_RECORD pReplaceSet,
  [in]                DWORD       Options,
  [in, optional]      HANDLE      hContext,
  [in, out, optional] PVOID       pExtraInfo,
  [in, out, optional] PVOID       pReserved
);

Parámetros

[in] pReplaceSet

Puntero a una estructura de DNS_RECORD que contiene el conjunto rr que reemplaza al conjunto existente. El conjunto rr especificado se reemplaza por el contenido de pNewSet. Para eliminar un conjunto rr, especifique el conjunto en pNewSet, pero establezca RDATA en NULL.

[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] hContext

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] pExtraInfo

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

Nota

El encabezado windns.h define DnsReplaceRecordSet como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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

DnsModifyRecordsInSet