annotate 특성
[annotate] 특성을 사용하면 지정된 메서드, 매개 변수 또는 구조체 필드에 대한 SAL 주석 문자열을 지정할 수 있습니다.
[ annotation(“stringâ€0, [, function-attribute-list] ] function-declarator ;
[ [function-attribute-list] ] type-specifier [pointer-declarator] function-name(
[ annotation(“stringâ€) [ , parameter-attribute-list ] ] type-specifier [declarator]
, ...);
-
string
-
지정된 SAL 주석 문자열입니다.
-
function-attribute-list
-
함수에 적용되는 0개 이상의 특성을 지정합니다. 유효한 함수 특성에는 [콜백]이 포함됩니다. 포인터 특성 [ref], [unique]또는 [ptr]; 및 사용 특성 [string], [ignore] 및 [context_handle]. 여러 특성을 쉼표로 구분해야 합니다.
-
function-declarator
-
함수의 형식 지정자, 함수 이름 및 매개 변수 목록을 지정합니다.
-
type-specifier
-
base_type, [구조체], 공용 구조체 또는 [열거형] 형식 또는 형식 식별자를 지정합니다. 선택적 스토리지 사양은 형식 지정자보다 우선할 수 있습니다.
-
pointer-declarator
-
포인터 선언자를 0개 이상 지정합니다. 포인터 선언자는 C에서 사용되는 포인터 선언자와 동일합니다. * 지정자, 멀리와 같은 한정자 및 한정자 [const]에서 생성됩니다.
-
function-name
-
원격 프로시저의 이름을 지정합니다.
-
parameter-attribute-list
-
매개 변수 형식에 적합한 0개 이상의 특성을 지정합니다. [in] 특성이 있는 매개 변수 특성은 방향 특성 [out]을 사용할 수도 있습니다. 필드 특성 [first_is], [last_is], [length_is], [max_is], [size_is], [switch_type]; 포인터 특성 [ref], [unique]또는 [ptr]; 및 사용 특성 [context_handle] 및 [string]. 사용 특성 [ignore] 는 매개 변수 특성으로 사용할 수 없습니다. 여러 특성을 쉼표로 구분해야 합니다.
-
declarator
-
식별자, 포인터 선언자 및 배열 선언자와 같은 표준 C 선언자를 지정합니다. 자세한 내용은 배열 및 Sized-Pointer 특성, [배열] 및 배열 및 포인터를 참조하세요. 매개 변수 이름과 같은 함수 선언자의 매개 변수 선언자는 선택 사항입니다.
[주석] 특성을 사용하면 MIDL에서 생성된 SAL 주석을 재정의하거나 MIDL에서 주석을 명시적으로 생성하지 않는 위치에 추가할 수 있습니다. 명령줄에 /sal 을 지정하지 않으면 이 특성은 무시됩니다.