LSA_OPEN_SAM_USER 콜백 함수(ntsecpkg.h)

SAM(보안 계정 관리자) 데이터베이스에서 사용자 계정에 대한 핸들을 검색합니다 .

구문

LSA_OPEN_SAM_USER LsaOpenSamUser;

NTSTATUS LsaOpenSamUser(
  [in]  PSECURITY_STRING Name,
  [in]  SECPKG_NAME_TYPE NameType,
  [in]  PSECURITY_STRING Prefix,
  [in]  BOOLEAN AllowGuest,
  [in]  ULONG Reserved,
  [out] PVOID *UserHandle
)
{...}

매개 변수

[in] Name

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

[in] NameType

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

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

[in] Prefix

SecNameAlternateId의 NameType을 사용하는 이름과 함께 사용할 접두사를 지정하는 UNICODE_STRING 구조체에 대한 포인터입니다.

[in] AllowGuest

SAM 계정을 찾을 수 없는 경우 게스트 계정을 사용할지 여부를 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
FALSE	사용자를 찾을 수 없으면 OpenSamUser 함수 호출이 실패합니다.
TRUE	사용자를 찾을 수 없으며 게스트 계정을 사용하도록 설정하면 게스트 계정이 사용됩니다.

[in] Reserved

예약되어 있습니다. 0을 지정합니다.

[out] UserHandle

사용자 계정에 대한 핸들을 수신하는 포인터에 대한 포인터입니다.

반환 값

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

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

반환 코드	설명
STATUS_INVALID_PARAMETER	NameType 은 SecNameAlternateId이고 접두사는NULL입니다.
STATUS_NO_SUCH_USER	SAM 계정을 찾을 수 없습니다.

설명

UserHandle 매개 변수에서 받은 핸들을 닫려면 CloseSamUser 함수를 호출합니다.

사용자의 고유 이름은 사용자를 나타내는 Active Directory 개체의 이름, 도메인 및 전체 경로를 식별합니다.

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

요구 사항

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

추가 정보

CloseSamUser

LSA_SECPKG_FUNCTION_TABLE

SpInitialize