LSA_GET_AUTH_DATA_FOR_USER 콜백 함수(ntsecpkg.h)

아티클
08/25/2023

GetAuthDataForUser 함수는 SAM(보안 계정 관리자) 데이터베이스에서 사용자에 대한 인증 정보를 검색하여 ConvertAuthDataToken 함수에 적합한 형식으로 만듭니다.

구문

LSA_GET_AUTH_DATA_FOR_USER LsaGetAuthDataForUser;

NTSTATUS LsaGetAuthDataForUser(
  [in]  PSECURITY_STRING Name,
  [in]  SECPKG_NAME_TYPE NameType,
  [in]  PSECURITY_STRING Prefix,
  [out] PUCHAR *UserAuthData,
  [out] PULONG UserAuthDataSize,
  [out] PUNICODE_STRING UserFlatName
)
{...}

매개 변수

[in] Name

SAM 계정의 이름을 지정하는 UNICODE_STRING 구조체에 대한 포인터입니다.

[in] NameType

이름에서 계정 이름의 유형을 지정하는 SECPKG_NAME_TYPE 열거형 값입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
SecNameSamCompatible	이름은 SAM과 호환됩니다. SAM 호환 형식의 이름 예는 "ExampleDomain\Username"입니다.
SecNameAlternateId	이름은 SAM 계정의 AltSecId 속성에 있습니다. 이 값을 사용할 때 는 Prefix 매개 변수의 값을 지정해야 합니다.
SecNameFlat	이름은 일반 UPN( 사용자 계정 이름 ) 스타일 계정 이름입니다.
SecNameDN	Name 은 개체의 고유 이름입니다. 자세한 내용은 설명 부분을 참조하세요.

[in] Prefix

SecNameAlternateIdNameType으로 지정된 이름에 사용할 접두사를 포함하는 UNICODE_STRING 구조체에 대한 포인터입니다.

[out] UserAuthData

검색된 데이터의 주소를 받는 포인터입니다.

[out] UserAuthDataSize

검색된 데이터의 크기를 받는 ULONG 에 대한 포인터입니다.

[out] UserFlatName

해당하는 경우 UPN을 수신하는 UNICODE_STRING 구조체에 대한 포인터입니다.

반환 값

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

함수가 실패하면 반환 값은 실패한 이유를 나타내는 NTSTATUS 코드입니다.

설명

GetAuthDataForUser 함수는 OpenSamUser, GetUserAuthData 및 CloseSamUser 함수를 하나의 호출로 결합합니다.

이러한 함수에 대한 포인터는 SpInitialize 함수에서 받은 LSA_SECPKG_FUNCTION_TABLE 구조에서 사용할 수 있습니다.

요구 사항

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