RmAddFilter 함수(restartmanager.h)

애플리케이션 또는 서비스에 적용되는 종료 또는 다시 시작 작업을 수정합니다. 기본 설치 관리자는 RmAddFilter 함수를 여러 번 호출할 수 있습니다. 가장 최근의 호출은 동일한 파일, 프로세스 또는 서비스에 대한 이전 수정 사항을 재정의합니다.

구문

DWORD RmAddFilter(
  [in]           DWORD             dwSessionHandle,
  [in, optional] LPCWSTR           strModuleName,
  [in, optional] RM_UNIQUE_PROCESS *pProcess,
  [in, optional] LPCWSTR           strServiceShortName,
  [in]           RM_FILTER_ACTION  FilterAction
);

매개 변수

[in] dwSessionHandle

기존 다시 시작 관리자 세션에 대한 핸들입니다.

[in, optional] strModuleName

애플리케이션의 실행 파일에 대한 전체 경로를 포함하는 null로 끝나는 문자열 값에 대한 포인터입니다. 전체 경로에서 참조하는 애플리케이션에 대해 종료 또는 다시 시작 작업에 대한 수정 사항이 적용됩니다. Application 또는 strServiceShortName 매개 변수가 NULL이 아닌 경우 이 매개 변수는 NULL이어야 합니다.

[in, optional] pProcess

애플리케이션의 RM_UNIQUE_PROCESS 구조에 대한 포인터입니다. 종료 또는 다시 시작 작업에 대한 수정 사항은 RM_UNIQUE_PROCESS 구조에서 참조하는 애플리케이션에 적용됩니다. strFilename 또는 strShortServiceName 매개 변수가 NULL이 아닌 경우 이 매개 변수는 NULL이어야 합니다.

[in, optional] strServiceShortName

짧은 서비스 이름을 포함하는 null로 끝나는 문자열 값에 대한 포인터입니다. 종료 또는 다시 시작 작업에 대한 수정 사항은 짧은 서비스 파일 이름으로 참조되는 서비스에 적용됩니다. strFilename 또는 Application 매개 변수가 NULL이 아닌 경우 이 매개 변수는 NULL이어야 합니다.

[in] FilterAction

적용할 수정 유형을 지정하는 RM_FILTER_ACTION 열거형 값입니다.

반환 값

가장 최근에 받은 오류입니다. 함수는 Winerror.h에 정의된 시스템 오류 코드 중 하나를 반환할 수 있습니다.

값	의미
ERROR_SUCCESS 0	함수가 성공적으로 완료되었습니다.
ERROR_BAD_ARGUMENTS 160	하나 이상의 인수가 올바르지 않습니다. NULL 포인터 또는 0이 null이 아닌 값과 0이 아닌 값이 필요한 매개 변수로 전달되는 경우 이 오류 값은 Restart Manager 함수에서 반환됩니다.
ERROR_SESSION_CREDENTIAL_CONFLICT 1219	이 오류는 보조 설치 관리자가 이 함수를 호출할 때 반환됩니다. 이 함수는 기본 설치 관리자만 사용할 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	restartmanager.h
라이브러리	Rstrtmgr.lib
DLL	Rstrtmgr.dll

추가 정보

RmGetFilterList