Share via

Msv1_0SubAuthenticationRoutineEx 함수(subauth.h)

  • 아티클

LogonUser 함수를 호출하여 하위 인증을 요청할 때 원격 액세스 서비스 인증을 수행합니다.

보안 주체의 자격 증명 및 SAM( 보안 계정 관리자 ) 데이터베이스의 정보는 인증을 위해 이 함수에 전달됩니다.

이 함수는 MSV1_0 인증 패키지에 사용하기 위해 사용자 지정 하위 인증 패키지 DLL에 의해 구현됩니다.

이 함수는 비 자동 인증에 대해서만 호출되며, 계정이 있는 인증 서버에서만 호출되며, 레지스트리의 올바른 키 아래에 하위 인증 DLL이 등록된 경우에만 호출됩니다.

구문

NTSTATUS Msv1_0SubAuthenticationRoutineEx(
  [in]      NETLOGON_LOGON_INFO_CLASS LogonLevel,
  [in]      PVOID                     LogonInformation,
  [in]      ULONG                     Flags,
  [in]      PUSER_ALL_INFORMATION     UserAll,
  [in]      SAM_HANDLE                UserHandle,
  [in, out] PMSV1_0_VALIDATION_INFO   ValidationInfo,
  [out]     PULONG                    ActionsPerformed
);

매개 변수

[in] LogonLevel

LogonInformation 매개 변수에 지정된 정보 수준을 지정합니다. 이 매개 변수는 일반적으로 NetlogonInteractiveInformation으로 설정됩니다.

[in] LogonInformation

NETLOGON_LOGON_IDENTITY_INFO 구조체에 대한 포인터입니다. 이 구조체의 멤버는 로그온하는 사용자에 대한 정보를 포함합니다. 이 구조체의 LogonDomainName 멤버는 무시됩니다.

[in] Flags

선택 사항입니다. 로그온 상황을 설명하는 플래그를 포함합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
MSV1_0_PASSTHRU
 통과 인증. 사용자가 이 컴퓨터에 연결하지 않습니다.
MSV1_0_GUEST_LOGON
 게스트 사용자 계정을 사용하여 로그온을 다시 시도합니다.

[in] UserAll

SAM 데이터베이스에서 반환된 사용자에 대한 설명을 포함하는 USER_ALL_INFORMATION 구조체에 대한 포인터입니다.

[in] UserHandle

사용자 계정에 대한 핸들입니다.

[in, out] ValidationInfo

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

[out] ActionsPerformed

수행된 작업 목록입니다.

반환 값

이 함수는 다음 값 중 하나를 반환해야 합니다.

반환 코드 설명
STATUS_SUCCESS
 오류가 없었습니다.
STATUS_ACCOUNT_DISABLED
 계정을 사용할 수 없습니다.
STATUS_ACCOUNT_EXPIRED
 계정이 만료되었습니다.
STATUS_ACCOUNT_LOCKED_OUT
 계정이 잠겼습니다.
STATUS_INVALID_INFO_CLASS
 LogonLevel 이 잘못되었습니다.
STATUS_INVALID_WORKSTATION
 사용자는 지정된 워크스테이션에 로그온할 권한이 없습니다.
STATUS_NO_SUCH_USER
 지정된 사용자에게 계정이 없습니다.
STATUS_PASSWORD_EXPIRED
 암호가 만료되었습니다.
STATUS_PASSWORD_MUST_CHANGE
 다음 로그온에서 암호를 변경해야 함을 나타내는 계정이 표시됩니다.
STATUS_WRONG_PASSWORD
 암호가 잘못되었습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 subauth.h