out 특성
[out] 특성은 호출된 프로시저에서 호출 프로시저(서버에서 클라이언트로)로 반환되는 포인터 매개 변수를 식별합니다.
[ [function-attribute-list] ] type-specifier [pointer-declarator] function-name(
[ out [ , parameter-attribute-list ] ] type-specifier [declarator]
, ...
);
매개 변수
-
function-attribute-list
-
함수에 적용되는 0개 이상의 특성을 지정합니다. 유효한 함수 특성은 [콜백], [로컬]입니다. 포인터 특성 [ref], [unique]또는 [ptr]; 및 사용 특성 [string], [ignore] 및 [context_handle].
-
type-specifier
-
base_type, 구조체, 공용 구조체 또는 열거형 형식 또는 형식 식별자를 지정합니다. 선택적 스토리지 사양은 형식 지정자보다 우선할 수 있습니다.
-
pointer-declarator
-
포인터 선언자를 0개 이상 지정합니다. 포인터 선언자는 C에서 사용되는 포인터 선언자와 동일합니다. * 지정자, 멀리와 같은 한정자 및 한정자 const에서 생성됩니다.
-
function-name
-
원격 프로시저의 이름을 지정합니다.
-
parameter-attribute-list
-
지정된 매개 변수 형식에 적합한 0개 이상의 특성을 지정합니다. [out] 특성이 있는 매개 변수 특성은 방향 특성 [out]을 사용할 수도 있습니다. 필드 특성 [first_is], [last_is], [length_is], [max_is], [size_is] 및 [switch_type]; 포인터 특성 [ref], [unique]또는 [ptr]; 및 사용 특성 [context_handle] 및 [string]. 사용 특성 [ignore]는 매개 변수 특성으로 사용할 수 없습니다. 여러 특성을 쉼표로 구분합니다.
-
declarator
-
식별자, 포인터 선언자 및 배열 선언자와 같은 표준 선언자를 지정합니다. 자세한 내용은 배열 및 Sized-Pointer 특성, 배열 및 배열 및 포인터를 참조하세요. 매개 변수 이름과 같은 함수 선언자의 매개 변수 선언자는 선택 사항입니다.
설명
[out] 특성은 포인터 역할을 하는 매개 변수와 메모리의 관련 데이터를 호출 프로시저에서 호출 프로시저로 다시 전달해야 했음을 나타냅니다.
[out] 특성은 포인터여야 합니다. DCE IDL 컴파일러에는 매개 변수 선언에 포인터 선언자로 명시적 *가 있어야 합니다. Microsoft IDL은 이 요구 사항을 삭제하고 배열 또는 이전에 정의된 포인터 형식을 허용하는 확장을 제공합니다.
관련 특성인 [in]은 매개 변수가 호출 프로시저에서 호출된 프로시저로 전달됨을 나타냅니다. [in] 및 [out] 특성은 매개 변수가 전달되는 방향을 지정합니다. 매개 변수는 [in]-only, [out]-only 또는 [in, out]으로 정의할 수 있습니다.
[out] 전용 매개 변수는 원격 프로시저가 호출되고 서버에서 개체에 대한 메모리를 할당할 때 정의되지 않은 것으로 간주됩니다. 최상위 포인터/매개 변수는 항상 유효한 스토리지를 가리킬 수 있으므로 NULL일 수 없으므로 최상위 [고유] 또는 [ptr] 포인터에 [out]을 적용할 수 없습니다. [unique] 또는 [ptr] 포인터인 매개 변수는 [in] 또는 [in, out] 매개 변수여야 합니다.
예
HRESULT MyFunction([out] short * pcount);
참고 항목