ClipboardObject.IDataObject.GetCanonicalFormatEtc 메서드
보다 복잡한 구조체와 논리적으로 일치하는 표준 FORMATETC 구조체를 제공합니다.이 메서드를 사용 하 여 두 여부를 확인 하려면 다른 FORMATETC 구조 중복 렌더링에 대 한 필요성을 제거 같은 데이터를 반환 합니다.
네임스페이스: Microsoft.VisualStudio.Data.Framework
어셈블리: Microsoft.VisualStudio.Data.Framework(Microsoft.VisualStudio.Data.Framework.dll)
구문
‘선언
Private Function GetCanonicalFormatEtc ( _
pformatectIn As FORMATETC(), _
pformatetcOut As FORMATETC() _
) As Integer Implements IDataObject.GetCanonicalFormatEtc
int IDataObject.GetCanonicalFormatEtc(
FORMATETC[] pformatectIn,
FORMATETC[] pformatetcOut
)
private:
virtual int GetCanonicalFormatEtc(
array<FORMATETC>^ pformatectIn,
array<FORMATETC>^ pformatetcOut
) sealed = IDataObject::GetCanonicalFormatEtc
private abstract GetCanonicalFormatEtc :
pformatectIn:FORMATETC[] *
pformatetcOut:FORMATETC[] -> int
private override GetCanonicalFormatEtc :
pformatectIn:FORMATETC[] *
pformatetcOut:FORMATETC[] -> int
JScript에서는 명시적 인터페이스 구현을 지원하지 않습니다.
매개 변수
- pformatectIn
형식: array<Microsoft.VisualStudio.OLE.Interop.FORMATETC[]
참조 하는 FORMATETC 구조, 형식, 보통 및 호출자와 같은 후속 호출에서 데이터를 검색 하려면 사용 하려는 대상 장치를 정의 하는 참조로 전달 된 IDataObject.GetData.이 경우 tymed 멤버는 중요하지 않으므로 무시됩니다.
- pformatetcOut
형식: array<Microsoft.VisualStudio.OLE.Interop.FORMATETC[]
이 메서드가 반환될 때 특정 렌더링에 사용할 수 있는 가장 일반적인 정보가 들어 있는 FORMATETC 구조체에 대한 포인터를 pformatectIn과 같은 형식으로 포함합니다.호출자는 이 구조체를 할당하고 GetCanonicalFormatEtc 메서드가 데이터를 채워야 합니다.같은 후속 호출에서 데이터를 검색할 수 IDataObject.GetData, 호출자는 제공 된 값을 사용 하 여 pformatetcOut, 제공 된 값이 아닌 경우 nullNull 참조(Visual Basic의 경우 Nothing).이 값은 메서드가 반환 하는 경우에 null입니다. DATA_S_SAMEFORMATETC.이 경우 tymed 멤버는 중요하지 않으므로 무시됩니다.이 매개 변수는 초기화되지 않은 상태로 전달됩니다.
반환 값
형식: System.Int32
이 메서드는 표준 반환 값을 지원 E_INVALIDARG, E_FAIL, E_UNEXPECTED, 및 E_OUTOFMEMORY, 다음 뿐만 아니라.
값 |
설명 |
|---|---|
S_OK |
반환 된 FORMATETC 구조체 전달 된 다른 것입니다. |
DATA_S_SAMEFORMATETC |
FORMATETC 구조체는 동일 하며 null 참조가 반환 되는 pformatetcOut 매개 변수. |
DV_E_LINDEX |
잘못 된 값에 대 한 lindex. 현재-1만 지원 됩니다. |
DV_E_FORMATETC |
pformatectIn 매개 변수의 값이 잘못된 경우 |
OLE_E_NOTRUNNING |
응용 프로그램이 실행되고 있지 않은 경우 |
구현
IDataObject.GetCanonicalFormatEtc(array<FORMATETC[], array<FORMATETC[])
설명
기존에 클립보드의 개체를 래핑하는 경우 IDataObject (에서 Microsoft.VisualStudio.OLE.Interop 네임 스페이스),이 메서드 호출에 해당 하는 위임 GetCanonicalFormatEtc 해당 네임 스페이스에서.그렇지 않으면 호출이 변환할 시도 GetCanonicalFormatEtc 에서 System.Runtime.InteropServices.ComTypes 네임 스페이스, 클립보드 개체의 경우에 수 수 배치는 기존 IDataObject.
.NET Framework 보안
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.