DnsReplaceRecordSetW 함수(windns.h)

DnsReplaceRecordSet 함수 형식은 기존 RR(리소스 레코드) 집합을 대체합니다. 많은 DNS 함수와 마찬가지로 DnsReplaceRecordSet 함수 형식은 접미사로 표시되는 다양한 문자 인코딩을 용이하게 하기 위해 여러 형식으로 구현됩니다. 관련된 문자 인코딩에 따라 다음 함수 중 하나를 사용합니다.

DNSReplaceRecordSetA (ANSI 인코딩에 대한 _A)

DnsReplaceRecordSetW (유니코드 인코딩용 _W)

DNSReplaceRecordSetUTF8 (UTF 8 인코딩의 경우 _UTF8)

함수 형식 이름과 접미사 사이에 밑줄이 없다는 점에 유의하세요. DnsReplaceRecordSet 함수 형식이 접미사(A, W 또는 UTF8)없이 호출되면 컴파일러 오류가 발생합니다.

구문

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

매개 변수

[in] pReplaceSet

기존 집합을 대체하는 RR 집합이 포함된 DNS_RECORD 구조체에 대한 포인터입니다. 지정된 RR 집합이 pNewSet의 내용으로 바뀝니다. RR 집합을 삭제하려면 pNewSet에서 집합을 지정하지만 RDATA 를 NULL로 설정합니다.

[in] Options

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

[in, optional] hContext

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

[in, out, optional] pExtraInfo

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

[in, out, optional] pReserved

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

반환 값

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

설명

참고

windns.h 헤더는 DNSReplaceRecordSet을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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

추가 정보

DNS_RECORD

DnsModifyRecordsInSet