PifMgr_OpenProperties 함수(shlobj_core.h)

[PifMgr_OpenProperties 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

Microsoft MS-DOS 애플리케이션과 연결된 .pif 파일을 열고 애플리케이션의 속성에 대한 핸들을 반환합니다.

구문

HANDLE PifMgr_OpenProperties(
  [in]           PCWSTR pszApp,
  [in, optional] PCWSTR pszPIF,
                 UINT   hInf,
                 UINT   flOpt
);

매개 변수

[in] pszApp

형식: PCWSTR

애플리케이션 이름을 포함하는 null로 끝나는 유니코드 문자열입니다.

[in, optional] pszPIF

형식: PCWSTR

.pif 파일의 이름을 포함하는 null로 끝나는 유니코드 문자열입니다.

hInf

형식: UINT

애플리케이션의 .inf 파일에 대한 핸들입니다. .inf 파일이 없는 경우 이 값을 0으로 설정합니다. .inf 파일이 처리되지 않도록 하려면 이 값을 -1로 설정합니다.

flOpt

형식: UINT

함수 작동 방식을 제어하는 플래그입니다.

OPENPROPS_INHIBITPIF

기존 .pif 파일을 무시하고 win.ini 또는 _Default.pif에서 속성을 가져옵니다. 이 플래그는 Windows NT, Windows 2000 및 Windows XP에서 무시됩니다.

OPENPROPS_NONE

옵션을 지정하지 않습니다.

반환 값

형식: HANDLE

애플리케이션의 속성에 대한 핸들을 반환합니다. 관련 .pif 함수를 호출할 때 이 핸들을 사용합니다.

설명

PifMgr_OpenProperties 파일을 여는 함수로 간주해서는 안 됩니다. .pif 파일은 이 호출 후에도 열려 있지 않습니다. 함수를 디스크 데이터를 사용하여 초기화할 수 있는 속성 구조 할당자로 생각하는 것이 더 유용합니다. 이 함수가 실패하는 주된 이유는 메모리가 부족하거나 지정된 .pif 파일을 열 수 없기 때문입니다.

.pif 파일이 없으면 함수는 여전히 메모리에 데이터 블록을 할당하고 _Default.pif 또는 내부 기본값의 데이터로 초기화합니다. 함수가 .pif 파일 이름을 찾지만 찾지 못하면 이름을 생성하고 내부 .pif 데이터 구조에 저장합니다. 이렇게 하면 PifMgr_SetProperties 호출되면 데이터가 디스크에 저장됩니다.

함수가 .pif 파일을 찾지 못하면 다음 순서로 검색합니다.

1. 현재 디렉터리를 검색합니다.
2. 지정된 디렉터리를 검색합니다.
3. .pif 디렉터리에서 검색합니다.
4. PATH 환경 변수에 지정된 폴더를 검색합니다.

요구 사항

추가 정보

PifMgr_CloseProperties

PifMgr_GetProperties