다음을 통해 공유


알림(설치 API)

알림은 설정 함수가 상태 또는 이벤트를 지정하기 위해 콜백 루틴에 보내는 값입니다. Param1Param2의 두 매개 변수는 알림과 함께 전송되며 알림과 관련된 추가 정보를 포함합니다.

콜백 루틴은 알림을 처리하고 설정 함수에 부호 없는 정수를 반환합니다. 설치 함수에 따라 이 값을 사용하여 작업 또는 사용자 선택을 지정하거나 무시할 수 있습니다.

설치 함수는 다음 구문을 사용하여 콜백 루틴에 알림을 보냅니다.

MsgHandler(          //the specified callback routine
    Context,         //context used by the callback routine
    Notification,    //notification code
    Param1,          //additional notification information
    Param2           //additional notification information
);

Context 매개 변수는 콜백 루틴이 콜백 루틴에 대한 후속 호출 사이에 유지해야 하는 정보를 저장하는 데 사용할 수 있는 컨텍스트 변수 또는 구조에 대한 void 포인터입니다.

콜백 루틴은 컨텍스트의 구현을 지정하고 설치 함수에 의해 참조되거나 변경되지 않으므로 컨텍스트는 다음에 나타나는 알림 메시지에 대한 참조 자료에 문서화되지 않습니다.

Notification 매개 변수는 설정 함수가 콜백 루틴을 호출하도록 하는 이벤트 또는 상태에 대한 부호 없는 정수 값을 지정합니다.

Param1Param2 는 알림과 관련된 추가 정보를 포함할 수 있는 선택적 매개 변수입니다. 이러한 매개 변수는 부호 없는 정수입니다. Param1 또는 Param2가 부호 없는 정수가 아닌 정보를 반환하는 경우 부호 없는 정수로 캐스팅되며 콜백 루틴에서 사용하려면 먼저 원래 데이터 형식으로 다시 캐스팅해야 합니다.

참고

다음 알림은 설치 함수에서 사용하는 모든 알림을 나타냅니다. 개별 함수는 이러한 알림의 하위 집합을 사용합니다. 즉, 모든 알림이 모든 함수에서 사용되는 것은 아닙니다.

 

다음 알림은 설치 함수에서 사용됩니다.

알림 설명
SPFILENOTIFY_COPYERROR 파일 복사 작업 중에 오류가 발생했습니다.
SPFILENOTIFY_DELETEERROR 파일 삭제 작업 중에 오류가 발생했습니다.
SPFILENOTIFY_ENDCOPY 파일 복사 작업이 종료되었습니다.
SPFILENOTIFY_ENDDELETE 파일 삭제 작업이 종료되었습니다.
SPFILENOTIFY_ENDQUEUE 큐 커밋이 완료되었습니다.
SPFILENOTIFY_ENDREGISTRATION 파일 등록 또는 등록 취소가 완료되었습니다.
SPFILENOTIFY_ENDRENAME 파일 이름 바꾸기 작업이 종료되었습니다.
SPFILENOTIFY_ENDSUBQUEUE 하위 큐(복사, 이름 바꾸기 또는 삭제)가 종료되었습니다.
SPFILENOTIFY_FILEEXTRACTED 파일이 캐비닛에서 추출되었습니다.
SPFILENOTIFY_FILEINCABINET 캐비닛에 파일이 있습니다.
SPFILENOTIFY_FILEOPDELAYED 파일이 사용 중이었고 시스템이 다시 부팅될 때까지 현재 작업이 지연되었습니다.
SPFILENOTIFY_LANGMISMATCH 현재 작업의 언어가 시스템 언어와 일치하지 않습니다.
SPFILENOTIFY_NEEDMEDIA 새 원본 미디어가 필요합니다.
SPFILENOTIFY_NEEDNEWCABINET 현재 파일은 다음 캐비닛에서 계속됩니다.
SPFILENOTIFY_QUEUESCAN 파일 큐의 노드가 검사되었습니다.
SPFILENOTIFY_QUEUESCAN_EX 파일 큐의 노드가 검사되었습니다.
SPFILENOTIFY_QUEUESCAN_SIGNERINFO 파일 큐의 노드가 검사되었습니다.
SPFILENOTIFY_RENAMEERROR 파일 이름 바꾸기 작업 중에 오류가 발생했습니다.
SPFILENOTIFY_STARTCOPY 파일 복사 작업이 시작되었습니다.
SPFILENOTIFY_STARTDELETE 파일 삭제 작업이 시작되었습니다.
SPFILENOTIFY_STARTQUEUE 큐가 커밋되기 시작했습니다.
SPFILENOTIFY_STARTREGISTRATION 파일 등록 또는 등록 취소가 시작되었습니다.
SPFILENOTIFY_STARTRENAME 파일 이름 바꾸기 작업이 시작되었습니다.
SPFILENOTIFY_STARTSUBQUEUE 하위 큐(복사, 이름 바꾸기 또는 삭제)가 시작되었습니다.
SPFILENOTIFY_TARGETEXISTS 지정된 파일의 복사본이 대상에 이미 있습니다.
SPFILENOTIFY_TARGETNEWER 지정된 파일의 최신 버전이 대상에 있습니다.