RmRemoveFilter 함수(restartmanager.h)

RmAddFilter 함수를 사용하여 적용된 종료 또는 다시 시작 작업에 대한 수정 사항을 제거합니다. 기본 설치 관리자는 RmRemoveFilter 함수를 여러 번 호출할 수 있습니다.

구문

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

매개 변수

[in] dwSessionHandle

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

[in, optional] strModuleName

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

[in, optional] pProcess

애플리케이션의 RM_UNIQUE_PROCESS 구조입니다. RmRemoveFilter 함수는 이전에 RmAddFilter 함수에 의해 적용된 참조된 애플리케이션의 종료 또는 다시 시작 작업에 대한 수정 사항을 제거합니다. strFilename 또는 strShortServiceName 매개 변수가 NULL이 아닌 경우 이 매개 변수는 NULL이어야 합니다.

[in, optional] strServiceShortName

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

반환 값

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

값	의미
ERROR_SUCCESS 0	함수가 성공적으로 완료되었습니다.
ERROR_FILE_NOT_FOUND 1	지정된 필터를 찾을 수 없습니다.
ERROR_SESSION_CREDENTIAL_CONFLICT 1219	이 오류는 보조 설치 관리자가 이 함수를 호출할 때 반환됩니다. 이 함수는 기본 설치 관리자만 사용할 수 있습니다.

요구 사항

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