MddBootstrapInitialize 함수(mddbootstrap.h)
지정된 조건과 가장 일치하는 Windows 앱 SDK 프레임워크 패키지 버전을 사용하도록 호출 프로세스를 초기화합니다. 이 함수는 외부 위치로 패키지되거나 패키지되지 않은 데스크톱 앱에서 사용됩니다.
MddBootstrapInitialize2MddBootstrapInitialize비해 유용성 및 문제 해결 개선 사항을 제공합니다.
또한 상수참조하세요.
구문론
HRESULT MddBootstrapInitialize(
UINT32 majorMinorVersion,
PCWSTR versionTag,
PACKAGE_VERSION minVersion
);
매개 변수
majorMinorVersion
형식: UINT32
Windows 앱 SDK의 주 및 부 버전은 로드할 제품 (예: 1.2). 이는 일치하는 정확한 주 버전 및 부 버전입니다. 최소값이 아닙니다.
majorMinorVersion0xMMMMNNNN인코딩됩니다. 여기서 M = 주 및 N = 부 버전(예: 버전 1.2는 0x00010002인코딩됨).
versionTag
형식: PCWSTR
로드할 Windows 앱 SDK 프레임워크 패키지의 버전 태그입니다(있는 경우). 예: "prerelease".
minVersion
형식: PACKAGE_VERSION
사용할 Windows 앱 SDK 런타임 패키지(majorMinorVersion일치)의 최소 버전입니다.
이 버전(예: 0.319.455)은 Windows 앱 SDK 릴리스 버전(예: 1.0.2) 및 제품 버전(예: 1.0)과 다릅니다.
Windows 앱 SDK 런타임 버전 값은 C++ 헤더 WindowsAppSDK-VersionInfo.h가져올 수 있습니다. 자세한 내용은 예제 참조하세요.
반환 값
형식: HRESULT
함수가 성공하면 ERROR_SUCCESS반환합니다. 그렇지 않으면 함수는 오류 코드를 반환합니다.
비고
모든 오류는 EventLog의 애플리케이션 채널에 기록됩니다.
매개 변수가 호환되는 경우 이 함수를 여러 번 호출할 수 있습니다. 첫 번째 호출은 Framework 패키지를 확인하는 작업을 수행합니다. 후속 호출은 매개 변수가 첫 번째 호출로 확인된 Framework 패키지와 호환되는 경우 no-op. 후속 호출의 매개 변수가 호환되지 않으면 API가 실패하고 오류를 반환합니다.
이 함수는 지정된 조건을 충족하고 현재 프로세스에서 패키지를 사용할 수 있도록 하는 Windows 앱 SDK 프레임워크 패키지를 찾습니다. 여러 패키지가 조건을 충족하는 경우 이 함수는 가장 적합한 후보를 선택합니다.
부트스트래퍼 구성 요소가 Windows 앱 SDK를 제대로 초기화하고 프레임워크 패키지에 런타임 참조를 추가할 수 있도록 다른 Windows 앱 SDK API를 호출하기 전에 시작 시 이 함수를 호출해야 합니다.
또한 이 함수는 DDLM(동적 종속성 수명 관리자)초기화합니다. DDLM은 패키지되지 않은 앱에서 사용되는 동안 운영 체제(OS)가 Windows 앱 SDK 프레임워크 패키지를 서비스하지 못하도록 하는 인프라를 제공합니다.
또한 외부 위치 또는 패키지되지 않은 패키지된 앱에 Windows 앱 SDK 런타임 사용참조하세요.
메모
이 함수를 호출하기 전에 현재 스레드에 대해 COM을 초기화해야 합니다.
메모
이 API가 패키지되지 않은 앱에서 성공하려면 Windows 앱 SDK 패키지를 디바이스에 설치해야 합니다(자습서의 필수 구성 요소 섹션 참조: 외부 위치로 패키지되었거나 Windows 앱 SDK사용하는 패키지되지 않은 앱에서 부트스트래퍼 API 사용).
예시
MddBootstrapInitialize2예제를 참조하세요.
요구 사항
| 요구 사항 | 가치 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 버전 1809(Windows 앱 SDK 1.0 이상 포함) |
| 헤더 | mddbootstrap.h |
| 라이브러리 | Microsoft.WindowsAppRuntime.Bootstrap.lib |
| DLL | Microsoft.WindowsAppRuntime.Bootstrap.dll |