INF ProfileItems 지시문
주의
Windows 11 버전 22H2부터 이 지시문을 사용하는 드라이버 패키지는 더 이상 하드웨어 개발자 센터의 서명을 받을 수 없습니다.
유니버설 드라이버 패키지 및 Windows 드라이버는 이 지시문을 사용할 수 없습니다.
ProfileItems 지시문은 INF DDInstall 섹션에서 시작 메뉴 추가 또는 제거할 항목 또는 그룹을 포함하는 하나 이상의 프로필 항목 섹션을 나열하는 데 사용됩니다.
[DDInstall]
ProfileItems=profile-items-section[,profile-items-section]...
...
ProfileItems 지시문에서 참조하는 명명된 각 섹션에는 다음과 같은 형식이 있습니다.
[profile-items-section]
Name=link-name[,name-attributes]
CmdLine=dirid,[subdir],filename
[SubDir=path]
[WorkingDir=wd-dirid,wd-subdir]
[IconPath=icon-dirid,[icon-subdir],icon-filename]
[IconIndex=index-value]
[HotKey=hotkey-value]
[Infotip=info-tip]
[DisplayResource="ResDllPath\ResDll",ResID]
이 지시문은 Windows XP 이상 버전의 Windows에서 지원됩니다.
엔트리
Name=link-name[,name-attributes]
링크 이름은 .lnk 확장명 없이 메뉴 항목 또는 그룹의 링크 이름을 지정합니다. 이 값은 INF 파일의 문자열 섹션에 정의된 문자열 또는 %strkey% 토큰일 수 있습니다. DisplayResource 항목을 지정하지 않으면 링크 이름도 표시 문자열입니다.
선택적 이름 특성 값은 메뉴 항목의 작업에 영향을 주는 하나 이상의 플래그를 지정합니다. 이 값은 시스템 정의 플래그 값의 ORed 비트 마스크로 표현됩니다. 가능한 플래그는 다음과 같습니다.
0x00000001(FLG_PROFITEM_CURRENTUSER)
Windows가 현재 사용자 프로필에서 시작 메뉴 항목을 만들거나 삭제하도록 지시합니다. 이 플래그를 지정하지 않으면 Windows는 모든 사용자의 항목을 처리합니다.
0x00000002(FLG_PROFITEM_DELETE)
Windows에서 메뉴 항목을 삭제하도록 지시합니다. 이 플래그를 지정하지 않으면 항목이 만들어집니다.
0x00000004(FLG_PROFITEM_GROUP)
Windows가 Start\Programs에서 시작 메뉴 그룹을 만들거나 삭제하도록 지시합니다. 이 플래그를 지정하지 않으면 Windows에서 메뉴 그룹이 아닌 메뉴 항목을 만들거나 삭제합니다.
플래그를 지정하지 않으면 Windows에서 모든 사용자에 대한 메뉴 항목을 만듭니다.
CmdLine=dirid,[subdir],filename
dirid는 명령 프로그램이 상주하는 디렉터리를 식별하는 값을 지정합니다. 예를 들어 11의 dirid 는 시스템 디렉터리를 나타냅니다. 가능한 dirid 값은 DestinationDirs 섹션의 dirid 값 설명에 나열됩니다.
하위 문자열이 있는 경우 명령 프로그램은 dirid에서 참조하는 디렉터리의 하위 디렉터리에 있습니다. 하위 디렉터리가 하위 디렉터리를 지정합니다. 하위 디렉터리가 지정되지 않은 경우 프로그램은 dirid에서 참조하는 디렉터리에 있습니다.
파일 이름은 메뉴 항목과 연결된 프로그램의 이름을 지정합니다.
SubDir=path
이 선택적 항목은 메뉴 항목이 있는 Start\Programs 아래에 하위 디렉터리(하위 메뉴)를 지정합니다. 이 항목을 생략하면 경로가 기본적으로 Start\Programs로 설정됩니다.
예를 들어 profile-items-section에 "Subdir=Accessories\Games" 항목이 있는 경우 Start\Programs\Accessories\Games 하위 메뉴에서 메뉴 항목이 생성되거나 삭제됩니다.
참고 항목
이름 특성에 대해 FLG_PROFITEM_GROUP 지정되면 SubDir 항목이 무시됩니다.
WorkingDir=wd-dirid[,wd-subdir]
이 선택적 항목은 명령 프로그램의 작업 디렉터리를 지정합니다. 이 항목을 생략하면 작업 디렉터리가 기본적으로 명령 프로그램이 있는 디렉터리로 설정됩니다.
wd-dirid 값은 작업 디렉터리를 식별합니다. 가능한 dirid 값 목록은 Dirids 사용을 참조 하세요.
wd-subdir 문자열(있는 경우)은 wd-dirid의 하위 디렉터리를 작업 디렉터리로 지정합니다. 이 매개 변수를 사용하여 시스템 정의 dirid가 없는 디렉터리를 지정합니다. 이 매개 변수를 생략 하면 wd-dirid 값만 작업 디렉터리를 지정합니다.
IconPath=icon-dirid,[icon-subdir],icon-filename
이 선택적 항목은 메뉴 항목에 대한 아이콘이 포함된 파일의 위치를 지정합니다.
icon-dirid 문자열은 아이콘이 포함된 DLL의 디렉터리를 식별합니다. 가능한 dirid 값 목록은 Dirids 사용을 참조 하세요.
icon-subdir 값(있는 경우)은 DLL이 icon-dirid의 하위 디렉터리에 있음을 나타냅니다. icon-subdir 값은 하위 디렉터리를 지정합니다.
icon-filename 값은 아이콘이 포함된 DLL을 지정합니다.
이 항목을 생략하면 Windows는 CmdLine 항목에 지정된 파일에서 아이콘을 찾습니다.
IconIndex=index-value
이 선택적 항목은 메뉴 항목에 사용할 DLL의 아이콘을 지정합니다. DLL에서 아이콘을 인덱싱하는 방법에 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.
IconPath 항목을 지정하면 인덱스 값이 해당 DLL로 인덱싱됩니다. 그렇지 않으면 이 값이 CmdLine 항목에 지정된 파일로 인덱싱됩니다.
HotKey=hotkey-value
이 선택적 항목은 메뉴 항목에 대한 키보드 가속기를 지정합니다.
핫 키에 대한 자세한 내용은 Windows SDK 설명서를 참조하세요.
Infotip=info-tip
이 선택적 항목은 메뉴 항목에 대한 정보 팁을 지정합니다.
이 값은 INF 파일의 문자열 섹션에 정의된 문자열 또는 %strkey% 토큰일 수 있습니다.
정보 팁 값은 "@ResDllPath\ResDll,-ResID"로 지정할 수도 있습니다. 여기서 ResDllPath 및 ResDll은 리소스 DLL의 경로 및 파일 이름을 지정하고 -resID는 리소스 ID를 나타내는 음수 값입니다.
이 형식을 사용하여 Windows MUI(다국어 사용자 인터페이스)를 지원합니다. 예제는 다음과 같습니다.
InfoTip = "@%11%\shell32.dll,-22531"
DisplayResource="ResDllPath\ResDll",ResID
이 선택적 항목은 시작 메뉴 바로 가기 또는 그룹의 표시 이름으로 사용할 지역화 가능한 문자열을 식별하는 문자열 리소스를 지정합니다.
ResDllPath 및 ResDll 은 리소스 DLL의 경로 및 파일 이름을 지정하고 resID 는 리소스 ID를 나타내는 양수 값입니다. 예제는 다음과 같습니다.
DisplayResource="%11%\shell32.dll",22019
이 항목을 사용하여 MUI(Windows 다국어 사용자 인터페이스)를 지원합니다. 이 항목을 사용하지 않으면 이름 항목에 지정된 문자열이 표시됩니다.
설명
지정된 프로필-항목-섹션 이름은 INF 파일 내에서 고유해야 하며 섹션 이름을 정의하기 위한 일반 규칙을 따라야 합니다. 이러한 규칙에 대한 자세한 내용은 INF 파일에 대한 일반 구문 규칙을 참조 하세요.
각 프로필 항목 섹션에는 하나의 시작 메뉴 항목 또는 그룹을 만들거나 제거하기 위한 자세한 정보가 포함되어 있습니다. INF에서 둘 이상의 메뉴 항목 또는 그룹을 조작하려면 둘 이상의 프로필 항목 섹션 을 만들고 ProfileItems 지시문의 섹션을 나열합니다 .
INF 파일의 일반 구문 규칙에 설명된 대로 프로필-항목-섹션 항목에 지정된 문자열 매개 변수는 %strkey% 토큰을 사용하여 지정할 수 있습니다.
예제
다음 INF 파일 발췌에서는 프로필 항목 섹션을 사용하여 시작 메뉴에 계산기를 추가하는 방법을 보여 있습니다.
[CalcInstallItems]
Name = %Calc_DESC%
CmdLine = 11,, calc.exe
SubDir = %Access_GROUP%
WorkingDir = 11
InfoTip = %Calc_TIP%
:
:
[Strings]
AccessGroup = "Accessories"
Calc_DESC = "Calculator"
Calc_TIP = "Performs basic arithmetic tasks with an on-screen calculator"
다음 INF 파일 발췌에서는 DisplayResource 항목을 사용하여 지역화된 메뉴 항목을 만들어 동일한 소프트웨어를 설치하는 방법을 보여줍니다.
[CalcInstallItems]
Name = %Calc_DESC%
CmdLine = 11,, calc.exe
SubDir = %Access_GROUP%
WorkingDir = 11
InfoTip = "@%11%\shell32.dll,-22531"
DisplayResource="%11%\shell32.dll",22019
:
:
[Strings]
Access_GROUP = "Accessories"
Calc_DESC = "Calculator"