INF UpdateIniFields 지시문

아티클
02/07/2024

주의

Windows 11 버전 22H2부터 이 지시문을 사용하는 드라이버 패키지는 하드웨어 개발자 센터의 서명에 더 이상 적합하지 않습니다.

유니버설 드라이버 패키지 및 Windows 드라이버는 이 지시문을 사용할 수 없습니다.

UpdateIniFields 지시문은 INI 파일의 줄 내에서 세분화된 수정을 지정할 수 있는 하나 이상의 명명된 섹션을 참조합니다.

[DDInstall] | 
[DDInstall.CoInstallers] | 
[ClassInstall32] | 
[ClassInstall32.ntx86] | 
[ClassInstall32.ntia64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntamd64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows)
[ClassInstall32.ntarm64] (Windows 10 version 1709 and later versions of Windows)

UpdateIniFields=update-inifields-section[,update-inifields-section]...

UpdateIniFields 지시문에서 참조하는 명명된 각 섹션에는 다음과 같은 형식이 있습니다.

[update-inifields-section]
 
ini-file,ini-section,profile-name[,old-field][,new-field][,flags]
...

update-inifields-section에는 INF 작성기로 결정된 항목 수가 각각 별도의 줄에 있을 수 있습니다.

항목

ini-file
원본 미디어에 제공된 INI 파일의 이름을 지정하고, 암시적으로 대상 컴퓨터에서 업데이트할 INI 파일의 이름을 지정합니다. 이 값은 파일 이름 또는 INF 파일의 Strings 섹션에 정의된 %strkey% 토큰으로 표현할 수 있습니다.

ini-section
수정할 줄이 포함된 지정된 INI 파일 내의 섹션 이름을 지정합니다.

profile-name
지정된 INI 섹션 내에서 수정할 줄의 이름을 지정합니다. 이 줄의 수정에 영향을 주려면 이전 필드 및/또는 새 필드 항목 중 하나 이상을 지정해야 합니다.

이전 필드
지정된 줄 내의 기존 필드를 지정합니다. 이 섹션 항목에서 new-field 를 생략하면 이 필드는 지정된 줄에서 삭제됩니다. 그렇지 않으면 지정된 새 필드 값이 이 필드를 바꿔야 합니다.

new-field
지정된 이전 필드에 대한 대체를 지정하거나 , 이전 필드를 생략하면 지정된 줄에 추가됩니다.

flags
지정된 새 필드를 지정된 줄에 추가할 때 사용할 구분 기호 문자(*) 및/또는 (비트 1)이 있거나 둘 다포함된 경우 지정된이전-필드 및/또는 -새 필드를 해석하는 방법을 비트 0으로 지정합니다.

비트 0 = 0
INI 파일의 지정된 줄에서 일치 항목을 검색할 때 지정된 이전 필드 및/또는 new-field 항목의 별표(*)를 와일드 카드 문자가 아닌 문자 그대로 해석합니다. 이것은 기본값입니다.

비트 0 = 1
INI 파일의 지정된 줄에서 일치 항목을 검색할 때 지정된 이전 필드 및/또는 새 필드 항목의 별표(*)를 야생 카드 문자로 해석합니다.

비트 1 = 0
지정된 새 필드 항목을 INI 파일의 지정된 줄에 추가할 때 공백 문자를 구분 기호로 사용합니다. 이것은 기본값입니다.

비트 1 = 1
지정된 새 필드 항목을 INI 파일의 지정된 줄에 추가할 때 쉼표(,)를 구분 기호로 사용합니다.

설명

UpdateIniFields 지시문은 배포 미디어에 INI 파일이 필요하지 않으므로 Windows에서 설치하기 위해 INF 파일에 거의 지정되지 않습니다. 그러나 UpdateIniFields 지시문은 공식 구문 문에 표시된 섹션과 AddInterface 지시문에서 참조하거나 InterfaceInstall32 섹션에서 참조하는 INF-writer-defined 섹션에서 유효합니다.

각 update-inifields-section 이름은 INF 파일에 고유해야 합니다. INF 작성기에서 만든 각 섹션 이름은 INF 파일 내에서 고유해야 하며 섹션 이름을 정의하기 위한 일반적인 규칙을 따라야 합니다. 이러한 규칙에 대한 자세한 내용은 INF 파일에 대한 일반 구문 규칙을 참조하세요.

UpdateInis 지시문에서 참조하는 섹션과 달리 UpdateIniFields에서 참조하는 섹션은 특정 줄의 전체 값에 영향을 주지 않고 기존 INI 파일 줄에서 줄의 일부를 대체, 추가 또는 삭제합니다. 각 섹션 항목에서 이전 필드 및/또는 새 필드 값 중 하나 이상을 지정해야 합니다.

수정할 INI 파일 줄의 주석은 이 섹션에 따라 변경된 후에는 적용되지 않을 수 있으므로 제거됩니다. INI 파일의 줄에서 필드를 찾는 경우 공백, 탭 및 쉼표는 필드 구분 기호로 해석됩니다. 그러나 공백 문자는 줄에 새 필드가 추가될 때 기본 구분 기호로 사용됩니다.

INF는 다음 방법 중 하나로 배포 미디어에 지정된 ini-file 의 전체 경로를 제공합니다.

IHV/OEM 제공 INF 파일에서 이 INF의 SourceDisksNames 및 SourceDisksFiles 섹션을 사용하여 배포 미디어의 루트 디렉터리(또는 디렉터리)에 없는 명명된 각 원본 파일의 전체 경로를 명시적으로 지정합니다.
시스템에서 제공하는 INF 파일에서 INF 파일의 버전 섹션에 있는 LayoutFile 항목에 식별된 하나 이상의 추가 INF 파일을 제공합니다.