PFNDAVAUTHCALLBACK 콜백 함수(davclnt.h)

아티클
08/23/2023

WebDAV 클라이언트는 애플리케이션 정의 DavAuthCallback 콜백 함수를 호출하여 사용자에게 자격 증명을 묻는 메시지를 표시합니다.

PFNDAVAUTHCALLBACK 형식은 이 콜백 함수에 대한 포인터를 정의합니다. DavAuthCallback 은 애플리케이션 정의 함수 이름의 자리 표시자입니다.

구문

PFNDAVAUTHCALLBACK Pfndavauthcallback;

DWORD Pfndavauthcallback(
  [in]      LPWSTR lpwzServerName,
  [in]      LPWSTR lpwzRemoteName,
  [in]      DWORD dwAuthScheme,
  [in]      DWORD dwFlags,
  [in, out] PDAV_CALLBACK_CRED pCallbackCred,
  [in, out] AUTHNEXTSTEP *NextStep,
  [out]     PFNDAVAUTHCALLBACK_FREECRED *pFreeCred
)
{...}

매개 변수

[in] lpwzServerName

대상 서버의 이름을 포함하는 NULL로 종료된 유니코드 문자열에 대한 포인터입니다.

[in] lpwzRemoteName

네트워크 리소스의 이름을 포함하는 NULL로 끝나는 유니코드 문자열에 대한 포인터입니다.

[in] dwAuthScheme

사용할 인증 체계를 지정하는 플래그의 비트 마스크입니다.

값	의미
DAV_AUTHN_SCHEME_BASIC 0x00000001	기본 인증을 사용해야 합니다.
DAV_AUTHN_SCHEME_NTLM 0x00000002	Microsoft NTLM 인증을 사용해야 합니다.
DAV_AUTHN_SCHEME_PASSPORT 0x00000004	Passport 인증 을 사용해야 합니다.
DAV_AUTHN_SCHEME_DIGEST 0x00000008	Microsoft 다이제스트 인증 을 사용해야 합니다.
DAV_AUTHN_SCHEME_NEGOTIATE 0x00000010	Microsoft Negotiate 를 사용해야 합니다.
DAV_AUTHN_SCHEME_CERT 0x00010000	인증서 인증을 사용해야 합니다.
DAV_AUTHN_SCHEME_FBA 0x00100000	양식 기반 인증을 사용해야 합니다.

[in] dwFlags

WebDAV 서비스가 NPAddConnection3 함수를 호출할 때 dwFlags 매개 변수에 전달한 플래그입니다.

[in, out] pCallbackCred

DAV_CALLBACK_CRED 구조체에 대한 포인터입니다.

[in, out] NextStep

DavAuthCallback 콜백 함수를 성공적으로 호출한 후 WebDAV 클라이언트가 수행해야 하는 다음 작업을 지정하는 AUTHNEXTSTEP 열거형 값에 대한 포인터입니다.

[out] pFreeCred

DavFreeCredCallback 콜백 함수에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

함수가 실패하면 반환 값은 시스템 오류 코드입니다.

설명

DavRegisterAuthCallback 함수를 호출하여 DavAuthCallback 콜백 함수를 등록해야 합니다.

이 콜백 함수의 등록을 취소하려면 DavUnregisterAuthCallback 함수를 사용합니다.

이 콜백 함수는 사용자에게 자격 증명(사용자 이름 및 암호 또는 인증 BLOB)을 묻는 메시지를 표시하고 pCallbackCred 매개 변수가 가리키는 DAV_CALLBACK_CRED 구조의 적절한 멤버에 이 정보를 저장해야 합니다.

요구 사항


지원되는 최소 클라이언트	WINDOWS Vista SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	WINDOWS Server 2008 SP2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	davclnt.h