Funzione DnsReplaceRecordSetA (windns.h)

Articolo
03/09/2024

Il tipo di funzione DnsReplaceRecordSet sostituisce un set di record di risorse esistente (RR). Come molte funzioni DNS, il tipo di funzione DnsReplaceRecordSet viene implementato in più moduli per facilitare la codifica di caratteri diversa, che è indicato da un suffisso. In base alla codifica dei caratteri coinvolta, usare una delle funzioni seguenti:

DnsReplaceRecordSetA (_A per la codifica ANSI)

DnsReplaceRecordSetW (_W per la codifica Unicode)

DnsReplaceRecordSetUTF8 (_UTF8 per la codifica UTF 8)

Tenere presente la mancanza di un carattere di sottolineatura tra il nome del tipo di funzione e il relativo suffisso. Se il tipo di funzione DnsReplaceRecordSet viene chiamato senza il relativo suffisso (A, W o UTF8), si verificherà un errore del compilatore.

Sintassi

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

Parametri

[in] pReplaceSet

Puntatore a una struttura DNS_RECORD contenente il set RR che sostituisce il set esistente. Il set RR specificato viene sostituito con il contenuto di pNewSet. Per eliminare un set RR, specificare il set in pNewSet, ma impostare RDATA su NULL.

[in] Options

Valore che contiene una bitmap di opzioni di aggiornamento DNS. Le opzioni possono essere combinate e tutte le opzioni sostituiscono DNS_UPDATE_SECURITY_USE_DEFAULT.

[in, optional] hContext

Handle per le credenziali di un account specifico. Usato quando è necessario un aggiornamento dinamico sicuro. Questo parametro è facoltativo e,

[in, out, optional] pExtraInfo

Questo parametro è riservato per l'uso futuro e deve essere impostato su NULL.

[in, out, optional] pReserved

Questo parametro è riservato per l'uso futuro e deve essere impostato su NULL.

Valore restituito

Restituisce la conferma dell'esito positivo al completamento positivo. In caso contrario, restituisce il codice di errore specifico del DNS appropriato come definito in Winerror.h.

Commenti

Nota

L'intestazione windns.h definisce DnsReplaceRecordSet come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	windns.h
Libreria	Dnsapi.lib
DLL	Dnsapi.dll

Vedi anche

DNS_RECORD

DnsModifyRecordsInSet

Condividi tramite