MsiGetComponentPathA 함수(msi.h)

  • 아티클

MsiGetComponentPath 함수는 설치된 구성 요소의 전체 경로를 반환합니다. 구성 요소의 키 경로가 레지스트리 키인 경우 레지스트리 키가 반환됩니다.

구문

INSTALLSTATE MsiGetComponentPathA(
  [in]      LPCSTR  szProduct,
  [in]      LPCSTR  szComponent,
  [out]     LPSTR   lpPathBuf,
  [in, out] LPDWORD pcchBuf
);

매개 변수

[in] szProduct

클라이언트 제품의 제품 코드를 지정합니다.

[in] szComponent

배치할 구성 요소의 구성 요소 ID를 지정합니다.

[out] lpPathBuf

구성 요소의 경로를 수신하는 변수에 대한 포인터입니다. 이 매개 변수는 null일 수 있습니다. 구성 요소가 레지스트리 키인 경우 레지스트리 루트는 숫자로 표시됩니다. 레지스트리 하위 키 경로인 경우 키 경로 끝에 백슬래시가 있습니다. 레지스트리 값 키 경로인 경우 끝에 백슬래시가 없습니다. 예를 들어 HKEY_CURRENT_USER\SOFTWARE\Microsoft 의 32비트 운영 체제에 대한 레지스트리 경로는 "01:\SOFTWARE\Microsoft"로 반환됩니다. 32비트 운영 체제에서 반환된 레지스트리 루트는 다음 표와 같이 정의됩니다.

참고 64비트 운영 체제에서는 32비트 운영 체제의 레지스트리 키 경로와 구분하기 위해 이 테이블의 숫자 레지스트리 루트에 값 20이 추가됩니다. 예를 들어 구성 요소 경로가 64비트 운영 체제의 레지스트리 키인 경우 HKEY_CURRENT_USER\SOFTWARE\Microsoft 의 레지스트리 키 경로는 "21:\SOFTWARE\Microsoft\"로 반환됩니다.
 
Root 의미
HKEY_CLASSES_ROOT
 00
HKEY_CURRENT_USER
 01
HKEY_LOCAL_MACHINE
 02
HKEY_USERS
 03

[in, out] pcchBuf

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

lpPathBuf가 null인 경우 pcchBuf는 null일 수 있습니다.

반환 값

MsiGetComponentPath 함수는 다음 값을 반환합니다.

값 의미
INSTALLSTATE_NOTUSED
 컴퓨터에서 요청되는 구성 요소를 사용할 수 없습니다.
INSTALLSTATE_ABSENT
 구성 요소가 설치되지 않았습니다.
INSTALLSTATE_INVALIDARG
 함수 매개 변수 중 하나가 잘못되었습니다.
INSTALLSTATE_LOCAL
 구성 요소가 로컬로 설치됩니다.
INSTALLSTATE_SOURCE
 구성 요소가 원본에서 실행되도록 설치됩니다.
INSTALLSTATE_SOURCEABSENT
 구성 요소 원본에 액세스할 수 없습니다.
INSTALLSTATE_UNKNOWN
 제품 코드 또는 구성 요소 ID를 알 수 없습니다.

설명

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

MsiGetComponentPath 함수는 다음과 같은 이유로 INSTALLSTATE_ABSENT 또는 INSTALL_STATE_UNKNOWN 반환할 수 있습니다.

  • INSTALLSTATE_ABSENT

    애플리케이션은 MsiUseFeature 및 필요한 경우 MsiConfigureFeature를 호출하여 기능이 설치되었는지 제대로 확인하지 못했습니다.

  • INSTALLSTATE_UNKNOWN

    이 기능은 게시되지 않습니다. 애플리케이션은 MsiQueryFeatureState 또는 MsiEnumFeatures를 호출하여 이전에 이를 결정했어야 합니다. 애플리케이션은 초기화하는 동안 이러한 호출을 합니다. 애플리케이션은 게시되는 것으로 알려진 기능만 사용해야 합니다. msiUseFeature에서도 INSTALLSTATE_UNKNOWN 반환되었어야 하므로 MsiUseFeature가 호출되지 않았거나 반환 값이 제대로 확인되지 않았습니다.

참고

msi.h 헤더는 MSiGetComponentPath를 유니코드 전처리기 상수의 정의에 따라 이 함수의 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

참고 항목

구성 요소별 함수