DllInstall 함수(shlwapi.h)

DLL에 대한 설치 및 설정을 처리합니다.

구문

HRESULT DllInstall(
                 BOOL   bInstall,
  [in, optional] PCWSTR pszCmdLine
);

매개 변수

bInstall

형식: BOOL

DLL 이 설치되어 있으면 TRUE이고, 제거 중인 경우 FALSE입니다.

[in, optional] pszCmdLine

형식: PCWSTR

사용할 설치 프로시저를 나타내는 regsvr32 에 의해 전달된 문자열입니다. 이 값은 NULL일 수 있습니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 함수는 애플리케이션 설치 또는 설치 중에 사용하기 위해 DLL에서 이름으로 구현 및 내보낼 수 있습니다. dLL이 레지스트리에 정보 추가와 같은 작업을 수행할 수 있도록 regsvr32 에서 호출됩니다.

DllInstall 은 애플리케이션 설치 및 설정에만 사용됩니다. 애플리케이션에서 호출해서는 안 됩니다. DllRegisterServer 또는 DllUnregisterServer와 유사합니다. 이러한 함수와 달리 DllInstall 은 다양한 작업을 지정하는 데 사용할 수 있는 입력 문자열을 사용합니다. 이렇게 하면 적절한 조건에 따라 여러 가지 방법으로 DLL을 설치할 수 있습니다.

regsvr32와 함께 DllInstall을 사용하려면 콜론(:) 및 문자열 뒤에 "/i" 플래그를 추가합니다. 문자열은 pszCmdLine 매개 변수로 DllInstall에 전달됩니다. 콜론과 문자열을 생략하면 pszCmdLine 이 NULL로 설정됩니다. 다음 예제는 DLL을 설치하는 데 사용됩니다.

regsvr32 /i:"Install_1" dllname.dll

DllInstall 은 bInstall 이 TRUE 로 설정되고 pszCmdLine 이 "Install_1"로 설정된 상태에서 호출됩니다. DLL을 제거하려면 다음을 사용합니다.

regsvr32 /u /i:"Install_1" dllname.dll

위의 두 예제에서 DllRegisterServer 또는 DllUnregisterServer 도 호출됩니다. DllInstall만 호출하려면 "/n" 플래그를 추가합니다.

regsvr32 /n /i:"Install_1" dllname.dll

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shlwapi.h
DLL	Shlwapi.dll(버전 4.71 이상)