다음을 통해 공유

IDL 메서드 추가

  • 아티클

IDL 메서드 추가 마법사는 IDL 파일을 포함하는 ATL 프로젝트와 같은 IDL(Interface Definition Language) 인터페이스에 메서드를 추가합니다. MFC를 지원하는 프로젝트에서는 이 마법사를 사용할 수 없습니다.

이 마법사는 메서드 추가 마법사 및 IDL MFC 메서드 추가 마법사와 다음과 같은 측면에서 다릅니다.

  • 메서드 추가 마법사는 프로젝트의 인터페이스에 메서드를 추가하며, 인터페이스에 연결된 클래스를 업데이트할 수 있습니다.
  • IDL MFC 메서드 추가 마법사는 MFC, ActiveX 또는 MFC를 지원하는 ATL 프로젝트에서만 사용할 수 있습니다.

IDL 인터페이스에 메서드 추가

  1. 보기 메뉴에서 클래스 뷰를 선택합니다.

  2. 클래스 뷰 창에서 프로젝트 노드를 확장하여 메서드를 추가할 IDL 인터페이스(.idl 파일)를 표시합니다.

  3. 인터페이스의 이름을 마우스 오른쪽 단추로 클릭합니다.

  4. 바로 가기 메뉴에서 추가>메서드 추가를 선택합니다.

  5. IDL 메서드 추가 마법사에서 메서드를 만드는 데 필요한 정보를 제공합니다.

  6. 확인을 선택하여 메서드를 추가합니다.

사용자 인터페이스 요소 목록

다음 섹션에서는 메서드를 추가하는 데 사용할 마법사의 인터페이스에 대해 설명합니다.

Screenshot of adding a method using the wizard. Shows two parameters: [ in ] int i and [ in ] float f. Return type is HRESULT. Infer in out parameter values from type is selected.

  • 메서드 이름

    메서드의 이름을 지정합니다.

  • 반환 형식

    메서드에서 반환하는 데이터 형식입니다. 인터페이스에 정의된 메서드에서 오류 코드를 반환하는 표준 방법은 .를 사용하는 HRESULT것입니다.

    다음 표에서는 메서드를 추가할 수 있는 인터페이스의 종류와 허용되는 반환 형식에 대해 설명합니다. 이중 인터페이스와 사용자 지정 인터페이스의 경우에는 반환 형식이 HRESULT여야 하며, 마법사에서 이 반환 형식을 변경할 수 없습니다.

    인터페이스 종류 반환 형식
    이중 인터페이스 HRESULT. 변경할 수 없습니다.
    사용자 지정 인터페이스 HRESULT. 변경할 수 없습니다.
    로컬 사용자 지정 인터페이스 원하는 반환 형식을 지정하거나 드롭다운 목록에서 선택합니다.
    Dispinterface 원하는 반환 형식을 지정하거나 드롭다운 목록에서 선택합니다.

  • 매개 변수

    메서드의 매개 변수, 한정자 및 형식을 표시합니다.

  • +

    매개 변수를 추가합니다. 매개 변수에 매개 변수 형식, 이름 및 한정자를 입력합니다. 예를 들어, [in] int i를 입력하고 확인을 선택합니다.

  • x

    매개 변수 목록에서 선택한 매개 변수를 제거합니다.

  • 형식에서 in/out 매개 변수 값 유추

    매개 변수의 형식에 따라 [in] 또는 [out] 특성을 삽입합니다.

  • 마지막 매개 변수를 반환 값(retval)으로 설정

    마지막 매개 변수가 메서드의 반환 값으로 취급됩니다.

  • 특성

    다음 특성은 MIDL 참조에도 설명되어 있습니다.

    • id

      메서드를 식별하는 숫자 ID를 설정합니다. 자세한 내용은 id를 참조하세요.

    • call_as

      이 로컬 메서드가 매핑되는 원격 매서드의 이름을 지정합니다. 자세한 내용은 call_as를 참조하세요.

    • helpcontext

      도움말 파일에서 사용자가 이 메서드에 대한 정보를 볼 수 있는 컨텍스트 ID를 지정합니다. 자세한 내용은 helpcontext를 참조하세요.

    • helpstring

      적용되는 요소를 설명하는 데 사용되는 문자열을 지정합니다. 자세한 내용은 helpstring를 참조하세요.

  • 추가 특성

    • hidden

      항목이 존재하지만 사용자 기반 브라우저에는 표시되지 않아야 함을 나타냅니다. 자세한 내용은 hidden를 참조하세요.

    • local

      인터페이스 또는 함수가 원격이 아님을 지정합니다. 자세한 내용은 local를 참조하세요.

    • restricted

      모듈, 인터페이스 또는 dispinterface의 멤버나 라이브러리를 임의로 호출할 수 없음을 지정합니다. 자세한 내용은 restricted를 참조하세요.

    • source

      coclass, 속성 또는 메서드의 멤버가 이벤트의 소스임을 나타냅니다. coclass의 멤버의 경우 이 특성은 멤버가 구현되지 않고 호출됨을 의미합니다. 자세한 내용은 source를 참조하세요.

참조

메서드 추가 마법사
IDL MFC 메서드 추가 마법사