DnsModifyRecordsInSet_W 함수(windns.h)

DnsModifyRecordsInSet 함수는 이전에 DNS 서버에 등록되었을 수 있는 RR(리소스 레코드) 집합을 추가, 수정 또는 제거합니다.

많은 DNS 함수와 마찬가지로 DnsModifyRecordsInSet 함수 형식은 다양한 문자 인코딩을 용이하게 하기 위해 여러 형식으로 구현됩니다. 관련된 문자 인코딩에 따라 다음 함수 중 하나를 사용합니다.

• DNSMODIFYRECORDSINSET_A (ANSI 인코딩에 대한 _A)
• DnsModifyRecordsInSet_W (유니코드 인코딩에 대한 _W)
• DnsModifyRecordsInSet_UTF8 (UTF 8 인코딩의 경우 _UTF8)

구문

DNS_STATUS DnsModifyRecordsInSet_W(
  [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
);

매개 변수

[in, optional] pAddRecords

RR 집합에 추가할 RR 을 포함하는 DNS_RECORD 구조체에 대한 포인터입니다.

[in, optional] pDeleteRecords

RR 집합에서 삭제할 RR을 포함하는 DNS_RECORD 구조체에 대한 포인터입니다.

[in] Options

DNS 업데이트 옵션의 비트맵을 포함하는 값입니다. 옵션을 결합할 수 있으며 모든 옵션은 DNS_UPDATE_SECURITY_USE_DEFAULT 재정의할 수 있습니다.

[in, optional] hCredentials

특정 계정의 자격 증명에 대한 핸들입니다. 보안 동적 업데이트가 필요할 때 사용됩니다. 이 매개 변수는 선택적 요소입니다.

[in, out, optional] pExtraList

이 매개 변수는 나중에 사용하도록 예약되어 있으며 NULL로 설정해야 합니다.

[in, out, optional] pReserved

이 매개 변수는 나중에 사용하도록 예약되어 있으며 NULL로 설정해야 합니다.

반환 값

성공적으로 완료되면 성공 확인을 반환합니다. 그렇지 않으면 Winerror.h에 정의된 적절한 DNS 관련 오류 코드를 반환합니다.

설명

DnsModifyRecordsInSet 함수 형식은 다음 단계에서 실행됩니다.

1. pDeleteRecords에 지정된 레코드가 삭제됩니다. pDeleteRecords가 비어 있거나 현재 집합에 있는 레코드가 없는 경우 DnsModifyRecordsInSet 함수는 다음 단계로 이동합니다.
2. pAddRecords에 지정된 레코드가 추가됩니다. pAddRecords가 비어 있으면 레코드를 추가하지 않고 작업이 완료됩니다.

새 레코드를 추가하려면 pDeleteRecords에 레코드를 제공하지 않고 pAddRecords에 추가할 레코드를 제공합니다. 레코드를 수정하려면 pDeleteRecords에서 수정되는 레코드를 지정한 다음 pAddRecords에 배치하여 해당 레코드의 수정된 버전을 추가합니다. 레코드를 삭제하려면 삭제할 레코드만 지정합니다. DnsModifyRecordsInSet에 대한 단일 호출에서 여러 레코드를 추가하거나 삭제할 수 있습니다. 그러나 각 DNS_RECORDpName 멤버의 값은 동일해야 합니다. 그렇지 않으면 호출이 실패합니다. pAddRecords에 지정된 레코드가 이미 있는 경우 변경되지 않습니다.

서버 목록을 지정하지 않으면 기본 이름 서버가 쿼리됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	windns.h
라이브러리	Dnsapi.lib
DLL	Dnsapi.dll

추가 정보

DNS_RECORD

DnsQuery

DnsReplaceRecordSet