DnsAcquireContextHandle_A 함수(windns.h)
DnsAcquireContextHandle 함수 형식은 자격 증명 집합에 대한 컨텍스트 핸들을 가져옵니다. 많은 DNS 함수와 마찬가지로 DnsAcquireContextHandle 함수 형식은 다양한 문자 인코딩을 용이하게 하기 위해 여러 형식으로 구현됩니다. 관련된 문자 인코딩에 따라 다음 함수 중 하나를 사용합니다.
- DnsAcquireContextHandle_A (ANSI 인코딩에 대한 _A)
- DnsAcquireContextHandle_W (유니코드 인코딩에 대한 _W)
구문
DNS_STATUS DnsAcquireContextHandle_A(
[in] DWORD CredentialFlags,
[in, optional] PVOID Credentials,
[out] PHANDLE pContext
);
매개 변수
[in] CredentialFlags
문자 인코딩을 나타내는 플래그입니다. 유니코드의 경우 TRUE , ANSI의 경우 FALSE 로 설정합니다.
[in, optional] Credentials
보안 동적 업데이트에 사용할 계정의 이름, 도메인 및 암호를 포함하는 SEC_WINNT_AUTH_IDENTITY_W 구조체 또는 SEC_WINNT_AUTH_IDENTITY_A 구조체에 대한 포인터입니다. CredentialFlags가 TRUE로 설정된 경우 자격 증명은 SEC_WINNT_AUTH_IDENTITY_W 구조를 가리킵니다. 그렇지 않으면 자격 증명이 SEC_WINNT_AUTH_IDENTITY_A 구조를 가리킵니다. 지정하지 않으면 호출 서비스의 자격 증명이 사용됩니다. 이 매개 변수는 선택적 요소입니다.
[out] pContext
반환된 자격 증명을 가리키는 핸들에 대한 포인터입니다.
반환 값
성공적으로 완료되면 성공 확인을 반환합니다. 그렇지 않으면 은 Winerror.h에 정의된 적절한 DNS 관련 오류 코드를 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | windns.h |
| 라이브러리 | Dnsapi.lib |
| DLL | Dnsapi.dll |