IOleDocument::CreateView 메서드(docobj.h)

아티클
02/29/2024

호출자 프로세스에서 문서 뷰 개체를 만들고 해당 개체의 IOleDocumentView 인터페이스에 대한 포인터를 가져옵니다.

구문

HRESULT CreateView(
  [in]  IOleInPlaceSite  *pIPSite,
  [in]  IStream          *pstm,
  [in]  DWORD            dwReserved,
  [out] IOleDocumentView **ppView
);

매개 변수

[in] pIPSite

새 문서 뷰 개체와 연결할 뷰 사이트 개체를 나타내는 IOleInPlaceSite 인터페이스에 대한 포인터입니다. 예를 들어 보기가 초기화되지 않은 새 문서 개체에 포함된 경우 이 매개 변수는 NULL일 수 있습니다. 이 경우 호출자는 IOleDocumentView::SetInPlaceSite에 대한 후속 호출을 사용하여 뷰를 초기화해야 합니다.

[in] pstm

새 문서 뷰 개체가 자신을 초기화해야 하는 데이터가 포함된 스트림에 대한 포인터입니다. NULL인 경우 문서 개체는 새 문서 뷰 개체를 기본 상태로 초기화합니다.

[in] dwReserved

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

[out] ppView

새 문서 뷰 개체에 대한 인터페이스 포인터를 수신하는 IOleDocumentView 포인터 변수에 대한 포인터입니다. 성공하면 호출자는 뷰 개체가 더 이상 필요하지 않은 경우 ppview 포인터에서 IUnknown::Release를 호출합니다.

반환 값

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

반환 코드	설명
E_FAIL	작업이 실패했습니다.
E_OUTOFMEMORY	작업에 사용할 수 있는 메모리가 부족합니다.
E_UNEXPECTED	예기치 않은 오류가 발생했습니다.
E_POINTER	ppView의 주소는 NULL입니다.

설명

문서 개체 컨테이너의 문서 사이트는 CreateView 를 호출하여 문서 개체가 기본 데이터에서 또는 기존 스트림의 콘텐츠를 사용하여 컨테이너 프로세스에서 자체의 새 보기를 만들도록 지시합니다.

CreateView를 호출해도 새 보기가 표시되지 않습니다. 이렇게 하려면 IOleDocumentView::Show 또는 IOleDocumentView::UIActivate를 호출해야 합니다.

요구 사항

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