MpUpdateStart 함수
서명 업데이트 작업을 시작합니다.
구문
HRESULT WINAPI MpUpdateStart(
_In_ MPHANDLE hMpHandle,
_In_ DWORD dwUpdateOptions,
_In_opt_ PMPCALLBACK_INFO pCallbackInfo,
_Out_ PMPHANDLE phUpdateHandle
);
매개 변수
-
hMpHandle [in]
-
형식: MPHANDLE
맬웨어 보호 관리자 인터페이스에 대한 핸들입니다. 이 핸들은 MpManagerOpen 함수에 의해 반환됩니다.
-
dwUpdateOptions [in]
-
형식:DWORD
서명 업데이트 작업에 대한 옵션을 지정합니다. 다음 값 중 하나일 수 있습니다.
값 의미 - MPUPDATE_OPTION_NONE
특정 옵션이 요청되지 않습니다. - MPUPDATE_OPTION_ASYNC
업데이트 작업은 비동기입니다. 여기서 MpUpdateStart 는 서명 업데이트를 성공적으로 시작한 직후에 반환됩니다. (기본적으로 업데이트 작업은 동기적입니다. 즉, MpUpdateStart 는 서명 업데이트가 완료된 후에만 반환됩니다.) - MPUPDATE_OPTION_PROGRESS
호출자는 콜백을 통해 서명 업데이트 진행률 정보를 받는 데 관심이 있습니다. - MPUPDATE_OPTION_HTTP
서명 업데이트는 Microsoft 보안 포털 사이트에서 전체 서명 패키지를 다운로드하여 수행됩니다. 클라이언트에서 Microsoft 업데이트를 통해 서명 다운로드 문제가 발생하는 경우 대체 옵션으로 사용할 수 있습니다. - MPUPDATE_OPTION_UNC
UNC 공유에서 직접 다운로드를 사용하여 서명 업데이트를 수행합니다. - MPUPDATE_OPTION_MANAGED
관리 서비스 WSUS를 사용하여 서명 업데이트를 수행합니다. - MPUPDATE_OPTION_UNMANAGED
관리되지 않는 서비스 MU/WU를 사용하여 서명 업데이트를 수행합니다. -
pCallbackInfo [in, optional]
-
형식: PMPCALLBACK_INFO
서명 업데이트 상태 변경(예: 시작 및 완료) 및 진행률 정보를 클라이언트에 공급하는 데 사용되는 콜백 정보에 대한 포인터입니다. 콜백 함수에 전달된 MPCALLBACK_DATA 실제 업데이트 상태 및 진행률 관련 정보를 보고합니다. 다음은 가능한 콜백 목록입니다.
값 의미 - MPNOTIFY_SIGUPDATE_START
업데이트 작업이 시작되었습니다. - MPNOTIFY_SIGUPDATE_COMPLETE
업데이트 작업이 완료되었습니다. - MPNOTIFY_SIGUPDATE_SEARCH_START
업데이트 검색이 시작되었습니다. - MPNOTIFY_SIGUPDATE_SEARCH_COMPLETE
완료된 업데이트를 검색합니다. 추가 정보는 MPSIGUPDATE_DATA 구조를 통해 사용할 수 있습니다. - MPNOTIFY_SIGUPDATE_DOWNLOAD_START
업데이트를 위해 다운로드를 시작했습니다. - MPNOTIFY_SIGUPDATE_DOWNLOAD_PROGRESS
진행률 정보를 다운로드합니다. 추가 정보는 MPSIGUPDATE_DATA 구조를 통해 사용할 수 있습니다. - MPNOTIFY_SIGUPDATE_DOWNLOAD_COMPLETE
업데이트 완료를 위해 다운로드합니다. 추가 정보는 MPSIGUPDATE_DATA 구조를 통해 사용할 수 있습니다. - MPNOTIFY_SIGUPDATE_INSTALL_START
업데이트 설치가 시작되었습니다. - MPNOTIFY_SIGUPDATE_INSTALL_PROGRESS
설치 진행률 정보입니다. 추가 정보는 MPSIGUPDATE_DATA 구조를 통해 사용할 수 있습니다. - MPNOTIFY_SIGUPDATE_INSTALL_COMPLETE
업데이트 설치가 완료되었습니다. 추가 정보는 MPSIGUPDATE_DATA 구조를 통해 사용할 수 있습니다. - MPNOTIFY_SIGUPDATE_REQUEST_PROCESSED
맬웨어 방지 서비스는 서명 업데이트 요청을 처리했습니다. 실패 또는 성공은 MPCALLBACK_DATAhResult로 표시됩니다. - MPNOTIFY_SIGUPDATE_REBOOT_REQUIRED
업데이트 작업을 완료하려면 다시 부팅해야 합니다. 실패 또는 성공은 MPCALLBACK_DATAhResult로 표시됩니다. - MPNOTIFY_INTERNAL_FAILURE
서명 업데이트 작업에 일반 오류가 발생했습니다. MPCALLBACK_DATAhResult에는 특정 오류 코드가 있습니다. -
phUpdateHandle [out]
-
형식: PMPHANDLE
현재 시작된 서명 업데이트 작업을 식별하는 업데이트 핸들이 반환되었습니다. 이 핸들은 서명 업데이트 작업을 제어하는 등의 후속 함수 호출에서 사용할 수 있습니다. MpHandleClose 함수를 사용하여 핸들을 닫아야 합니다.
반환 값
형식: HRESULT
함수가 성공하면 반환 값이 S_OK.
함수가 실패하면 반환 값은 실패한 HRESULT 코드입니다. 호출자는 MpErrorMessageFormat 함수를 사용하여 오류 메시지에 대한 일반적인 설명을 가져올 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2012 [데스크톱 앱만 해당] |
| 헤더 |
|
| DLL |
|