필드 특성

  • 아티클

필드 특성은 배열, 구조체, 공용 구조체 또는 문자 배열의 필드에 적용할 수 있는 특성입니다.

예를 들어 필드 특성은 배열 선언과 함께 배열의 크기 또는 유효한 데이터가 포함된 배열 부분을 지정하는 데 사용됩니다. 이 작업은 다른 매개 변수, 구조 필드 또는 상수 식을 배열과 연결하여 수행됩니다.

[무시] 특성은 마샬링 프로세스 중에 무시될 포인터 필드를 지정합니다. 이러한 무시된 필드는 수신기 쪽에서 NULL 로 설정됩니다.

MIDL은 적합하고 다양하며 열린 배열을 제공합니다. 런타임에 범위가 결정되면 배열을 규칙적으로 호출합니다. [size_is] 특성은 배열의 할당 크기에 상한을 지정하고 [max_is] 특성은 유효한 배열 인덱스 값의 상한을 지정합니다. 자세한 내용은 [배열]을 참조하세요.

배열은 컴파일 시간에 범위가 결정되지만 전송된 요소의 범위가 런타임에 결정되는 경우 다양하게 호출됩니다. 개방형 배열(호환되는 다양한 배열이라고도 함)은 런타임에 상한 및 전송된 요소 범위가 결정되는 배열입니다. 배열의 전송된 요소 범위를 확인하려면 배열 선언에 [length_is], [first_is] 또는 [last_is] 특성이 포함되어야 합니다.

[length_is] 특성은 전송할 배열 요소 수를 지정하고 [first_is] 특성은 전송할 첫 번째 배열 요소의 인덱스를 지정합니다. [last_is] 특성은 전송할 마지막 배열 요소의 인덱스를 지정합니다.

[switch_is] 필드 특성은 공용 구조체 판별자를 지정합니다. union이 프로시저 매개 변수인 경우 공용 구조체 판별자는 동일한 프로시저의 다른 매개 변수여야 합니다. 공용 구조체가 구조체의 필드인 경우 판별자는 공용 구조체 필드와 동일한 수준에서 구조체의 다른 필드여야 합니다. 판별자는 부울, char, int 또는 열거형 형식이거나 이러한 형식 중 하나로 확인되는 형식이어야 합니다. 자세한 내용은 Nonencapsulated Unions and [switch_is]를 참조하세요.

[string] 필드 특성은 1차원 문자 또는 바이트 배열 또는 0으로 끝나는 문자 또는 바이트 스트림에 대한 포인터를 문자열로 처리하도록 지정합니다. 문자열 특성은 1차원 배열 및 포인터에만 적용됩니다. 요소 형식은 char, byte, wchar_t 또는 이러한 형식 중 하나로 확인되는 명명된 형식으로 제한됩니다.

필드 특성이 표시되는 컨텍스트에 대한 자세한 내용은 MIDL 배열, MIDL 구조체 및 MIDL 공용 구조체를 참조하세요.