IPersistFile::Load 메서드(objidl.h)

아티클
02/29/2024

지정된 파일을 열고 파일 내용에서 개체를 초기화합니다.

구문

HRESULT Load(
  [in] LPCOLESTR pszFileName,
  [in] DWORD     dwMode
);

매개 변수

[in] pszFileName

열 파일의 절대 경로입니다.

[in] dwMode

파일을 열 때 사용할 액세스 모드입니다. 가능한 값은 STGM 열거형에서 가져옵니다. 메서드는 이 값을 제안으로 처리하여 필요한 경우 더 제한적인 권한을 추가할 수 있습니다. dwMode가 0인 경우 구현은 사용자가 파일을 열 때 사용되는 모든 기본 권한을 사용하여 파일을 열어야 합니다.

반환 값

이 메서드는 다음 값을 반환할 수 있습니다.

반환 코드	Description
S_OK	메서드가 완료되었습니다.
E_OUTOFMEMORY	메모리 부족으로 인해 개체를 로드할 수 없습니다.
E_FAIL	메모리 부족 이외의 이유로 개체를 로드할 수 없습니다.

설명

IPersistFile::Load 는 지정된 파일에서 개체를 로드합니다. 이 메서드는 초기화 전용이며 최종 사용자에게 개체를 표시하지 않습니다. 사용자가 파일 열기 명령을 선택할 때 발생하는 것과 동일하지 않습니다.

발신자에 대한 참고 사항

파일 모니커의 BindToObject 메서드는 이 메서드를 호출하여 모니커 바인딩 작업 중에 개체를 로드합니다(연결된 개체를 실행할 때). 일반적으로 애플리케이션은 이 메서드를 직접 호출하지 않습니다.

구현자에 대한 참고 사항

파일을 여는 데 필요한 정보는 애플리케이션마다 크게 다르므로 이 메서드가 구현되는 개체도 pszFileName 매개 변수로 지정된 파일을 열어야 합니다. 이는 호출자가 스토리지 또는 스트림을 연 다음 열린 스토리지 또는 스트림 포인터를 로드된 개체에 전달하는 IPersistStorage ::Load 및 IPersistStream::Load와 다릅니다.

일반적으로 OLE 복합 파일을 사용하는 애플리케이션의 경우 IPersistFile::Load 구현은 단순히 StgOpenStorage 함수를 호출하여 지정된 파일에서 스토리지 개체를 열 수 있습니다. 그런 다음, 정상적인 초기화를 진행할 수 있습니다. 스토리지 개체를 사용하지 않는 애플리케이션은 일반적인 파일 열기 절차를 수행할 수 있습니다.

개체가 로드되면 구현에서 실행 중인 개체 테이블에 개체를 등록해야 합니다( IRunningObjectTable::Register 참조).

요구 사항

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

추가 정보

IPersistFile

다음을 통해 공유