다음을 통해 공유

MsiProvideComponentA 함수(msi.h)

  • 아티클

MsiProvideComponent 함수는 필요한 설치를 수행하여 전체 구성 요소 경로를 반환합니다. 이 함수는 필요한 경우 원본을 묻는 메시지를 표시하고 기능에 대한 사용 횟수를 증분합니다.

통사론

UINT MsiProvideComponentA(
  [in]      LPCSTR  szProduct,
  [in]      LPCSTR  szFeature,
  [in]      LPCSTR  szComponent,
  [in]      DWORD   dwInstallMode,
  [out]     LPSTR   lpPathBuf,
  [in, out] LPDWORD pcchPathBuf
);

매개 변수

[in] szProduct

필요한 구성 요소가 있는 기능을 포함하는 제품의 제품 코드를 지정합니다.

[in] szFeature

필요한 구성 요소를 사용하여 기능의 기능 ID를 지정합니다.

[in] szComponent

필요한 구성 요소의 구성 요소 코드를 지정합니다.

[in] dwInstallMode

설치 모드를 정의합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
INSTALLMODE_DEFAULT
 구성 요소를 제공하고 구성 요소를 제공하는 데 필요한 모든 설치를 수행합니다. 요청된 기능 또는 기능 부모에 있는 구성 요소의 키 파일이 누락된 경우 REINSTALLMODE_FILEMISSING, REINSTALLMODE_FILEOLDERVERSION, REINSTALLMODE_FILEVERIFY, REINSTALLMODE_MACHINEDATA, REINSTALLMODE_USERDATA 및 REINSTALLMODE_SHORTCUT 플래그 비트가 설정된 MsiReinstallFeature 사용하여 기능을 다시 설치합니다.
INSTALLMODE_EXISTING
 기능이 있는 경우에만 구성 요소를 제공합니다. 그렇지 않으면 ERROR_FILE_NOT_FOUND 반환합니다.

이 모드는 구성 요소의 키 파일이 있는지 확인합니다.
INSTALLMODE_NODETECTION
 기능이 있는 경우에만 구성 요소를 제공합니다. 그렇지 않으면 ERROR_FILE_NOT_FOUND 반환합니다.

이 모드는 구성 요소가 등록되어 있는지 확인하고 구성 요소의 키 파일이 있는지 확인하지 않습니다.
REINSTALLMODE 플래그 조합
 MsiReinstallFeature 호출하여 dwReinstallMode 매개 변수에 이 매개 변수를 사용하여 기능을 다시 설치한 다음 구성 요소를 제공합니다.
INSTALLMODE_NOSOURCERESOLUTION
 기능의 설치 상태가 INSTALLSTATE_LOCAL 경우에만 구성 요소를 제공합니다. 기능의 설치 상태가 INSTALLSTATE_SOURCE 경우 ERROR_INSTALL_SOURCE_ABSENT 반환합니다. 그렇지 않으면 ERROR_FILE_NOT_FOUND 반환합니다. 이 모드는 구성 요소가 등록되어 있는지 확인하고 키 파일이 있는지 확인하지 않습니다.

[out] lpPathBuf

구성 요소의 경로를 받는 변수에 대한 포인터입니다. 이 매개 변수는 null일 수 있습니다.

[in, out] pcchPathBuf

lpPathBuf 매개 변수가 가리키는 버퍼의 크기를 문자 단위로 지정하는 변수에 대한 포인터입니다. 입력에서 종료 null 문자에 대한 공간을 포함하여 버퍼의 전체 크기입니다. 전달된 버퍼가 너무 작으면 반환되는 개수에 종료 null 문자가 포함되지 않습니다.

lpPathBuf null이면 pcchBuf null일 수 있습니다.

반환 값

값 의미
ERROR_BAD_CONFIGURATION
 구성 데이터가 손상되었습니다.
ERROR_FILE_NOT_FOUND
 기능이 없거나 손상되었습니다. 이 오류는 dwInstallMode = INSTALLMODE_EXISTING 대해 반환됩니다.
ERROR_INSTALL_FAILURE
 설치에 실패했습니다.
ERROR_INSTALL_NOTUSED
 요청되는 구성 요소가 컴퓨터에서 비활성화됩니다.
ERROR_INVALID_PARAMETER
 잘못된 매개 변수가 함수에 전달되었습니다.
ERROR_SUCCESS
 함수가 성공적으로 완료되었습니다.
ERROR_UNKNOWN_FEATURE
 기능 ID는 알려진 기능을 식별하지 않습니다.
ERROR_UNKNOWN_PRODUCT
 제품 코드는 알려진 제품을 식별하지 않습니다.
INSTALLSTATE_UNKNOWN
 인식할 수 없는 제품 또는 기능 이름이 함수에 전달되었습니다.
ERROR_MORE_DATA
 버퍼 오버플로가 반환됩니다.
ERROR_INSTALL_SOURCE_ABSENT
 원본을 검색할 수 없습니다.
 

자세한 내용은 표시된 오류 메시지참조하세요.

발언

MsiProvideComponent 함수가 성공하면 pcchPathBuf 매개 변수에 lpPathBuf문자열 길이가 포함됩니다.

MsiProvideComponent 함수는 MsiUseFeature, MsiConfigureFeature및 msiGetComponentPath기능을 결합합니다. MsiProvideComponent 함수를 사용하여 호출 시퀀스를 간소화할 수 있습니다. 그러나 이 함수는 사용 횟수를 증가하므로 부정확한 사용 횟수를 방지하기 위해 주의해서 사용합니다. MsiProvideComponent 함수는 일련의 개별 호출보다 유연성이 낮습니다.

애플리케이션이 예기치 않은 상황에서 복구하는 경우 애플리케이션은 이미 msiUseFeature 호출하고 사용 횟수를 증가시켰을 것입니다. 이 경우 애플리케이션은 msiProvideComponent 대신 MsiConfigureFeature 호출하여 횟수가 다시 증가하지 않도록 해야 합니다.

INSTALLMODE_EXISTING 옵션은 REINSTALLMODE 플래그와 함께 사용할 수 없습니다.

손상된 파일 또는 잘못된 버전의 파일이 포함된 구성 요소가 있는 기능은 사용자가 명시적으로 다시 설치하거나 애플리케이션 호출 MsiReinstallFeature가.

메모

msi.h 헤더는 MSiProvideComponent를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows Server 2012, Windows 8, Windows Server 2008 R2 또는 Windows 7의 Windows Installer 5.0. Windows Server 2008 또는 Windows Vista의 Windows Installer 4.0 또는 Windows Installer 4.5. Windows Server 2003 또는 Windows XP의 Windows Installer Windows Installer 버전에 필요한 최소 Windows 서비스 팩에 대한 자세한 내용은 Windows Installer Run-Time 요구 사항을 참조하세요.
대상 플랫폼 Windows
헤더 msi.h
라이브러리 Msi.lib
DLL Msi.dll

참고 항목

Component-Specific 함수

Multiple-Package 설치