IOleObject::GetClipboardData 메서드(oleidl.h)

아티클
08/25/2023

이 메서드가 호출되는 포함된 개체의 현재 내용을 포함하는 데이터 개체를 검색합니다. 이 데이터 개체에 대한 포인터를 사용하면 원본과 동일한 데이터를 사용하여 포함된 새 개체를 만들 수 있습니다.

구문

HRESULT GetClipboardData(
  [in]  DWORD       dwReserved,
  [out] IDataObject **ppDataObject
);

매개 변수

[in] dwReserved

이 매개 변수는 예약되어 있으며 0이어야 합니다.

[out] ppDataObject

데이터 개체에 대한 인터페이스 포인터를 수신하는 IDataObject 포인터 변수의 주소입니다. 오류가 발생하면 ppDataObject 를 NULL로 설정해야 합니다. 개체가 IOleObject::GetClipboardData에 대한 호출을 받을 때마다 ppDataObject에서 참조 횟수를 늘려야 합니다. ppDataObject를 사용하여 릴리스를 호출하는 것은 호출자의 책임입니다.

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다. 다른 가능한 반환 값은 다음과 같습니다.

반환 코드	설명
E_NOTIMPL	GetClipboardData 는 지원되지 않습니다.
OLE_E_NOTRUNNING	개체가 실행되고 있지 않습니다.

설명

IOleObject::GetClipboardData 메서드를 사용하여 연결된 개체를 포함된 개체로 변환할 수 있습니다. 이 경우 컨테이너 애플리케이션은 IOleObject::GetClipboardData를 호출한 다음 받은 데이터를 OleCreateFromData에 전달합니다. 이 메서드는 표준 복사 작업으로 클립보드에 전달된 것과 동일한 데이터 개체에 대한 포인터를 반환합니다.

발신자에게 참고 사항

포함된 개체의 현재 콘텐츠에 대한 안정적인 스냅샷 원하는 경우 IOleObject::GetClipboardData를 호출합니다. 데이터가 변경되면 업데이트된 스냅샷 대해 함수를 다시 호출해야 합니다. 호출자에게 데이터에 발생하는 변경 내용을 알리려면 QueryInterface를 호출한 다음 , IDataObject::D Advise를 호출합니다.

구현자에 대한 참고 사항

이 함수를 구현하는 경우 데이터가 변경되지 않는 개체에 대한 IDataObject 포인터를 반환해야 합니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	oleidl.h