MsiProvideQualifiedComponentA 함수(msi.h)

  • 아티클

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

구문

UINT MsiProvideQualifiedComponentA(
  [in]      LPCSTR  szCategory,
  [in]      LPCSTR  szQualifier,
  [in]      DWORD   dwInstallMode,
  [out]     LPSTR   lpPathBuf,
  [in, out] LPDWORD pcchPathBuf
);

매개 변수

[in] szCategory

요청된 구성 요소의 구성 요소 ID를 지정합니다. 이는 구성 요소 자체의 GUID가 아니라 PublishComponent 테이블의 ComponentId 열과 같이 올바른 기능을 제공하는 서버일 수 있습니다.

[in] szQualifier

PublishComponent 테이블의 광고 구성 요소 목록에 한정자를 지정합니다.

[in] dwInstallMode

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

값 의미
INSTALLMODE_DEFAULT
 구성 요소를 제공하고 구성 요소를 제공하는 데 필요한 모든 설치를 수행합니다. 요청된 기능 또는 기능 부모에 있는 구성 요소의 키 파일이 누락된 경우 msiReinstallFeature 를 사용하여 REINSTALLMODE_FILEMISSING, REINSTALLMODE_FILEOLDERVERSION, REINSTALLMODE_FILEVERIFY, REINSTALLMODE_MACHINEDATA, REINSTALLMODE_USERDATA 및 REINSTALLMODE_SHORTCUT 플래그 비트가 설정된 기능을 다시 설치합니다.
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_INDEX_ABSENT
 구성 요소 한정자 가 잘못되었거나 없습니다.
ERROR_SUCCESS
 함수가 성공적으로 완료되었습니다.
ERROR_FILE_NOT_FOUND
 기능이 없거나 손상되었습니다. 이 오류는 dwInstallMode = INSTALLMODE_EXISTING 대해 반환됩니다.
ERROR_UNKNOWN_COMPONENT
 지정된 구성 요소를 알 수 없습니다.
작업과 관련된 오류
 오류 코드를 참조하세요.
초기화 오류
 초기화와 관련된 오류가 발생했습니다.

설명

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

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

참고

msi.h 헤더는 MSiProvideQualifiedComponent를 유니코드 전처리기 상수의 정의에 따라 이 함수의 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 런타임 요구 사항을 참조하세요.
대상 플랫폼 Windows
헤더 msi.h
라이브러리 Msi.lib
DLL Msi.dll

추가 정보

구성 요소별 함수

표시된 오류 메시지

오류 코드

초기화 오류

다중 패키지 설치