IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
public:
int GetCanonicalFormatEtc(System::Runtime::InteropServices::ComTypes::FORMATETC % formatIn, [Runtime::InteropServices::Out] System::Runtime::InteropServices::ComTypes::FORMATETC % formatOut);public int GetCanonicalFormatEtc(ref System.Runtime.InteropServices.ComTypes.FORMATETC formatIn, out System.Runtime.InteropServices.ComTypes.FORMATETC formatOut);abstract member GetCanonicalFormatEtc : FORMATETC * FORMATETC -> intPublic Function GetCanonicalFormatEtc (ByRef formatIn As FORMATETC, ByRef formatOut As FORMATETC) As Integer매개 변수
- formatIn
- FORMATETC
호출자가 후속 호출FORMATETC에서 데이터를 검색하는 GetData(FORMATETC, STGMEDIUM) 데 사용할 형식, 중간 및 대상 디바이스를 정의하는 참조로 전달되는 구조체에 대한 포인터입니다. 이 경우 멤버는 TYMED 중요하지 않으므로 무시해야 합니다.
- formatOut
- FORMATETC
이 메서드가 반환되면 특정 렌더링에 FORMATETC 대해 가능한 가장 일반적인 정보를 포함하는 구조체에 대한 포인터를 포함하므로 정식으로 동일합니다 formatetcIn. 호출자는 이 구조를 할당해야 하며 메서드는 GetCanonicalFormatEtc(FORMATETC, FORMATETC) 데이터를 채워야 합니다. 다음과 같은 GetData(FORMATETC, STGMEDIUM)후속 호출에서 데이터를 검색하려면 제공된 값이 아닌 한 호출자는 제공된 formatOut값을 null사용합니다. 이 값은 메서드가 반환null되는 경우입니다DATA_S_SAMEFORMATETC. 이 경우 멤버는 TYMED 중요하지 않으므로 무시해야 합니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.
반품
이 메서드는 E_INVALIDARG, E_UNEXPECTED 및 E_OUTOFMEMORY 표준 반환 값과 다음을 지원합니다.
| 값 | 설명 |
|---|---|
| S_ok | 반환 FORMATETC 된 구조체는 전달된 구조와 다릅니다. |
| DATA_S_SAMEFORMATETC | 구조체는 FORMATETC 동일하며 null 매개 변수에 formatOut 반환됩니다.
|
| DV_E_LINDEX | 에 잘못된 lindex값이 있습니다. 현재는 -1만 지원됩니다. |
| DV_E_FORMATETC | 매개 변수에 잘못된 값이 있습니다 formatIn .
|
| OLE_E_NOTRUNNING | 애플리케이션이 실행되고 있지 않습니다. |
설명
자세한 내용은 IDataObject::GetCanonicalFormatEtc 메서드를 참조하세요.
