Función DnsReplaceRecordSetA (windns.h)
El tipo de función DnsReplaceRecordSet reemplaza un conjunto de registros de recursos (RR) existente. Al igual que muchas funciones DNS, el DnsReplaceRecordSet tipo de función se implementa en varias formas 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 funciones siguientes:
dnsReplaceRecordSetA (_A para la codificación ANSI)
dnsReplaceRecordSetW (_W para la codificación Unicode)
dnsReplaceRecordSetUTF8 (_UTF8 para 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 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 de 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 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.
Observaciones
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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows 2000 Server [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
windns.h |
| biblioteca de |
Dnsapi.lib |
| DLL de |
Dnsapi.dll |