인터페이스 특성Interface Attributes

다음 특성은 interface (또는 __interface) C++ 키워드에 적용 됩니다.The following attributes apply to the interface (or __interface) C++ keyword.

특성Attribute 설명Description
async_uuidasync_uuid COM 인터페이스의 동기 버전과 비동기 버전을 모두 정의 하도록 MIDL 컴파일러에 지시 하는 UUID를 지정 합니다.Specifies the UUID that directs the MIDL compiler to define both synchronous and asynchronous versions of a COM interface.
customcustom 사용자 고유의 특성을 정의할 수 있습니다.Lets you define your own attributes.
dispinterfacedispinterface .Idl 파일의 인터페이스를 디스패치 인터페이스로 배치합니다.Places an interface in the .idl file as a dispatch interface.
dualdual 인터페이스를 .idl 파일에 이중 인터페이스로 배치 합니다.Places an interface in the .idl file as a dual interface.
exportexport 데이터 구조가 .idl 파일에 배치 되도록 합니다.Causes a data structure to be placed in the .idl file.
helpcontexthelpcontext 사용자가 도움말 파일에서이 요소에 대 한 정보를 볼 수 있는 컨텍스트 ID를 지정 합니다.Specifies a context ID that lets the user view information about this element in the Help file.
helpfilehelpfile 형식 라이브러리에 대 한 도움말 파일의 이름을 설정 합니다.Sets the name of the Help file for a type library.
helpstringhelpstring 적용되는 요소를 설명하는 데 사용되는 문자열을 지정합니다.Specifies a character string that is used to describe the element to which it applies.
helpstringcontexthelpstringcontext .Hlp 또는 .chm 파일에 있는 도움말 항목의 ID를 지정 합니다.Specifies the ID of a help topic in an .hlp or .chm file.
helpstringdllhelpstringdll 문서 문자열 조회 (지역화)를 수행 하는 데 사용할 DLL의 이름을 지정 합니다.Specifies the name of the DLL to use to perform document string lookup (localization).
hiddenhidden 항목이 존재 하지만 사용자 지향 브라우저에 표시 되지 않음을 나타냅니다.Indicates that the item exists but should not be displayed in a user-oriented browser.
library_blocklibrary_block .Idl 파일의 라이브러리 블록 안에 구문을 배치 합니다.Places a construct inside the .idl file's library block.
locallocal 인터페이스 헤더에서 사용 하는 경우 MIDL 컴파일러를 헤더 생성기로 사용할 수 있습니다.Allows you to use the MIDL compiler as a header generator when used in the interface header. 개별 함수에서 사용 하는 경우 스텁이 생성 되지 않는 지역 프로시저를 지정 합니다.When used in an individual function, designates a local procedure for which no stubs are generated.
nonextensiblenonextensible IDispatch 구현에 인터페이스 설명에 나열 된 속성 및 메서드만 포함 하 고 런타임에 추가 멤버로 확장할 수 없도록 지정 합니다.Specifies that the IDispatch implementation includes only the properties and methods listed in the interface description and cannot be extended with additional members at run time. 이 특성은 이중 인터페이스 에서만 유효 합니다.This attribute is only valid on a dual interface.
odlodl 인터페이스를 ODL (개체 설명 언어) 인터페이스로 식별 합니다.Identifies an interface as an Object Description Language (ODL) interface.
objectobject 사용자 지정 인터페이스를 식별 합니다.Identifies a custom interface.
oleautomationoleautomation 인터페이스가 자동화와 호환 됨을 나타냅니다.Indicates that an interface is compatible with Automation.
pointer_defaultpointer_default 매개 변수 목록에 표시 되는 최상위 포인터를 제외 하 고 모든 포인터에 대 한 기본 포인터 특성을 지정 합니다.Specifies the default pointer attribute for all pointers except top-level pointers that appear in parameter lists.
ptrptr 포인터를 전체 포인터로 지정 합니다.Designates a pointer as a full pointer.
restrictedrestricted 임의로 호출할 수 없는 라이브러리의 멤버를 지정 합니다.Designates which members of the library cannot be called arbitrarily.
uuiduuid 라이브러리의 고유 ID를 제공 합니다.Provides the unique ID for the library

인터페이스를 정의 하려면 다음 규칙을 따라야 합니다.You must observe these rules for defining an interface:

  • 기본 호출 규칙은 __stdcall입니다.Default calling convention is __stdcall.

  • GUID를 제공 하지 않으면 GUID가 제공 됩니다.A GUID is supplied for you if you do not supply one.

  • 오버 로드 된 메서드는 허용 되지 않습니다.No overloaded methods are allowed.

다른 특성 프로젝트에서 uuid 특성을 지정 하지 않고 동일한 인터페이스 이름을 사용 하는 경우 동일한 GUID가 생성 됩니다.When not specifying the uuid attribute and using the same interface name in different attribute projects, the same GUID is generated.

참고 항목See also

용도별 특성Attributes by Usage