다음을 통해 공유

IInkExtendedProperties::Add 메서드(msinkaut.h)

  • 아티클

IInkExtendedProperty 개체를 만들고 IInkExtendedProperties 컬렉션에 추가합니다.

구문

HRESULT Add(
  [in]          BSTR                 Guid,
  [in]          VARIANT              Data,
  [out, retval] IInkExtendedProperty **InkExtendedProperty
);

매개 변수

[in] Guid

새 IInkExtendedProperty 개체의 이름입니다. 이름은 다음 형식으로 GUID(Globally Unique Identifier)를 나타내는 BSTR로 표현됩니다.

{dfc71f44-354b-4ca1-93d7-7459410b6343} (중괄호 포함)

BSTR 데이터 형식에 대한 자세한 내용은 COM 라이브러리 사용을 참조하세요.

[in] Data

새 IInkExtendedProperty 개체에 대한 데이터입니다.

VARIANT 구조에 대한 자세한 내용은 COM 라이브러리 사용을 참조하세요.

[out, retval] InkExtendedProperty

이 메서드가 반환되면 는 새 확장 속성에 대한 포인터를 포함합니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
S_OK
 성공.
E_POINTER
 매개 변수에 잘못된 포인터가 포함되어 있습니다.
E_INVALIDARG
 사용자가 데이터를 지정하지 않았습니다.
CO_E_CLASSSTRING
 GUID 형식이 잘못되었습니다.
E_INK_EXCEPTION
 메서드 내에서 예외가 발생했습니다.
TPC_E_INVALID_STROKE
 스트로크가 잘못되었습니다.

설명

참고 빈 IInkExtendedProperty 개체는 저장할 수 없습니다. 개체는 저장되기 전에 데이터를 포함해야 합니다. 예를 들어 나중에 사용할 수 있도록 스트로크에 확장 속성을 추가하려고 하면 확장 속성에 데이터가 없는 경우 예외가 throw됩니다.
 
허용되는 형식은 다음과 같습니다.
  • 바이트 또는 CHAR 배열
  • 정수, 부동 소수점, 큰 정수, doubles, date 또는 decimals의 배열
  • 부울(부울 배열은 아님)
  • BSTR(BSTR 배열은 아님)
  • Variant 배열입니다. IInkExtendedProperty로 전달된 모든 변형 배열은 동일한 형식이어야 하며 모든 숫자여야 합니다. 예를 들어 BSTRS의 변형 배열, 배열 배열, VT_NULL 및 VT_EMPTY 지원되지 않습니다.
참고Guid 매개 변수가 IInkExtendedProperties 컬렉션에 이미 있는 GUID로 설정된 이 메서드를 호출하는 경우 새 데이터는 두 번째 요소를 추가하는 대신 해당 GUID의 기존 확장 속성을 대체합니다.
 

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버 지원되는 버전 없음
대상 플랫폼 Windows
헤더 msinkaut.h
라이브러리 InkObj.dll

추가 정보

IInkExtendedProperties 인터페이스

InkStrokes 컬렉션