다음을 통해 공유

LSA_REGISTER_NOTIFICATION 콜백 함수(ntsecpkg.h)

  • 아티클

보안 패키지에 알림을 제공하는 메커니즘을 제공합니다. 알림은 고정 간격, 이벤트 개체 신호 또는 특정 시스템 이벤트 중에 발생할 수 있습니다.

구문

LSA_REGISTER_NOTIFICATION LsaRegisterNotification;

HANDLE LsaRegisterNotification(
  [in] SEC_THREAD_START StartFunction,
  [in] PVOID Parameter,
  [in] ULONG NotificationType,
  [in] ULONG NotificationClass,
  [in] ULONG NotificationFlags,
  [in] ULONG IntervalMinutes,
  [in] HANDLE WaitEvent
)
{...}

매개 변수

[in] StartFunction

알림을 수락하기 위해 호출되는 함수입니다.

[in] Parameter

StartFunction 매개 변수에 지정된 함수의 인수입니다.

[in] NotificationType

알림 유형을 지정합니다. 다음 표에는 유효한 값이 나와 있습니다.

값 의미
NOTIFIER_TYPE_INTERVAL
 고정 간격으로 알립니다. IntervalMinutes 매개 변수를 사용하여 간격 길이를 나타냅니다.
NOTIFIER_TYPE_HANDLE_WAIT
 WaitEvent 매개 변수로 지정된 이벤트 핸들이 신호를 받으면 알립니다.
NOTIFIER_TYPE_STATE_CHANGE
 컴퓨터의 도메인 또는 설치 유형이 변경되면 알립니다.
NOTIFIER_TYPE_NOTIFY_EVENT
 보안 이벤트가 발생할 때 알립니다. NotificationClass 매개 변수를 사용하여 관심 이벤트를 지정합니다.
NOTIFIER_TYPE_IMMEDIATE
 즉시 알립니다. 이 값은 NOTIFIER_FLAG_ONE_SHOT 의미합니다.

[in] NotificationClass

알림을 생성하는 이벤트의 클래스를 지정합니다. NotificationType 매개 변수가 NOTIFIER_TYPE_NOTIFY_EVENT 설정되지 않는 한 0을 지정합니다.

값 의미
NOTIFY_CLASS_PACKAGE_CHANGE
 패키지가 로드되었거나 새 패키지가 기본 패키지로 선택되었습니다. 자세한 내용은 설명 부분을 참조하세요.
NOTIFY_CLASS_ROLE_CHANGE
 내부용으로 예약된 속성입니다.
NOTIFY_CLASS_DOMAIN_CHANGE
 내부용으로 예약된 속성입니다.

[in] NotificationFlags

알림 동작을 제어하는 플래그를 지정합니다.

값 의미
NOTIFIER_FLAG_NEW_THREAD
 새 스레드를 사용하여 알림을 기다립니다.
NOTIFIER_FLAG_ONE_SHOT
 한 번만 알립니다.
NOTIFIER_FLAG_SECONDS
 IntervalMinutes 매개 변수는 초를 지정합니다.

[in] IntervalMinutes

알림 사이의 시간 지연을 지정합니다.

[in] WaitEvent

선택 사항입니다. 이벤트 개체에 대한 핸들입니다. 개체가 신호를 받으면 알림이 발생합니다. 이 값은 NotificationType 값 NOTIFIER_TYPE_HANDLE_WAIT 함께 사용됩니다.

반환 값

함수가 성공하면 반환 값은 알림에 대한 핸들입니다.

함수가 실패하면 반환 값은 NULL입니다.

설명

NotificationClass 매개 변수에 대한 NOTIFY_CLASS_PACKAGE_CHANGE 값을 지정하는 경우 다음 값은 유효한 변경 내용을 나타냅니다.

값 Description
SECPKG_PACKAGE_CHANGE_LOAD 패키지가 로드되었습니다.
SECPKG_PACKAGE_CHANGE_UNLOAD 패키지가 언로드되었습니다.
SECPKG_PACKAGE_CHANGE_SELECT 새 패키지가 기본 보안 패키지가 되었습니다.
 

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

요구 사항

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

추가 정보

LSA_SECPKG_FUNCTION_TABLE

SpInitialize