다음을 통해 공유

CMonikerFile 클래스

  • 아티클

IMoniker에서 명명된 데이터 스트림(IStream)을 나타냅니다.

구문

class CMonikerFile : public COleStreamFile

멤버

공용 생성자

속성 설명
CMonikerFile::CMonikerFile CMonikerFile 개체를 생성합니다.

공용 메서드

이름 설명
CMonikerFile::Close 스트림을 분리하고 해제하고 모니커를 해제합니다.
CMonikerFile::D etach 이 CMonikerFile 개체에서 IMoniker 분리합니다.
CMonikerFile::GetMoniker 현재 모니커를 반환합니다.
CMonikerFile::Open 지정된 파일을 열어 스트림을 가져옵니다.

보호된 메서드

속성 설명
CMonikerFile::CreateBindContext 바인딩 컨텍스트를 가져오거나 초기화된 기본 바인딩 컨텍스트를 만듭니다.

설명

모니커에는 파일의 경로 이름과 같은 정보가 포함되어 있습니다. 모니커 개체의 IMoniker 인터페이스에 대한 포인터가 있는 경우 파일이 실제로 있는 위치에 대한 다른 특정 정보 없이 식별된 파일에 액세스할 수 있습니다.

에서 파생된 COleStreamFileCMonikerFile 모니커 또는 모니커로 만들 수 있는 문자열 표현을 사용하여 모니커가 이름인 스트림에 바인딩합니다. 그런 다음 해당 스트림을 읽고 쓸 수 있습니다. 실제 목적은 CMonikerFile 스트림에 직접 바인딩할 필요가 없도록 s로 명명된 IMonikers에 대한 간단한 액세스를 IStream제공하면서도 스트림에 대한 기능을 제공하는 CFile 것입니다.

CMonikerFile 는 스트림 이외의 다른 항목에 바인딩하는 데 사용할 수 없습니다. 스토리지 또는 개체에 바인딩하려면 인터페이스를 IMoniker 직접 사용해야 합니다.

스트림 및 모니커에 대한 자세한 내용은 Windows SDK의 MFC 참조 및 IStream 및 IMoniker에서 COleStreamFile을 참조하세요.

상속 계층 구조

CObject

CFile

COleStreamFile

CMonikerFile

요구 사항

헤더: afxole.h

CMonikerFile::Close

스트림을 분리 및 해제하고 모니커를 해제하려면 이 함수를 호출합니다.

virtual void Close();

설명

미개봉 또는 이미 닫힌 스트림에서 호출할 수 있습니다.

CMonikerFile::CMonikerFile

CMonikerFile 개체를 생성합니다.

CMonikerFile();

CMonikerFile::CreateBindContext

이 함수를 호출하여 초기화된 기본 바인딩 컨텍스트를 만듭니다.

IBindCtx* CreateBindContext(CFileException* pError);

매개 변수

pError
파일 예외에 대한 포인터입니다. 오류가 발생할 경우 원인으로 설정됩니다.

Return Value

성공한 경우 바인딩할 바인딩 컨텍스트 IBindCtx 에 대한 포인터입니다. 그렇지 않으면 NULL입니다. 인터페이스를 사용하여 인스턴스를 IBindHost 연 경우 바인딩 컨텍스트는 .에서 IBindHost검색됩니다. 인터페이스가 없거나 IBindHost 인터페이스가 바인딩 컨텍스트를 반환하지 못하면 바인딩 컨텍스트가 만들어집니다. IBindHost 인터페이스에 대한 설명은 Windows SDK를 참조하세요.

설명

바인딩 컨텍스트는 특정 모니커 바인딩 작업에 대한 정보를 저장하는 개체입니다. 사용자 지정 바인딩 컨텍스트를 제공하도록 이 함수를 재정의할 수 있습니다.

CMonikerFile::D etach

이 함수를 호출하여 스트림을 닫습니다.

BOOL Detach(CFileException* pError = NULL);

매개 변수

pError
파일 예외에 대한 포인터입니다. 오류가 발생할 경우 원인으로 설정됩니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

CMonikerFile::GetMoniker

현재 모니커에 대한 포인터를 검색하려면 이 함수를 호출합니다.

IMoniker* GetMoniker() const;

Return Value

현재 모니커 인터페이스( IMoniker)에 대한 포인터입니다.

설명

CMonikerFile 인터페이스가 아니므로 반환된 포인터는 AddRef를 통해 참조 횟수를 증가시키지 않으며 개체가 해제될 때 CMonikerFile 모니커가 해제됩니다. 모니커를 붙잡거나 직접 놓으려면 모니커를 놓아야 합니다 AddRef .

CMonikerFile::Open

이 멤버 함수를 호출하여 파일 또는 모니커 개체를 엽니다.

virtual BOOL Open(
    LPCTSTR lpszURL,
    CFileException* pError = NULL);

virtual BOOL Open(
    IMoniker* pMoniker,
    CFileException* pError = NULL);

매개 변수

lpszURL
열 파일의 URL 또는 파일 이름입니다.

pError
파일 예외에 대한 포인터입니다. 오류가 발생할 경우 원인으로 설정됩니다.

pMoniker
스트림을 가져오는 데 사용할 모니커 인터페이스 IMoniker 에 대한 포인터입니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

macintosh에서는 lpszURL 매개 변수를 사용할 수 없습니다. Macintosh에서는 pMoniker 형식 Open 만 사용할 수 있습니다.

lpszURL 매개 변수에 대한 URL 또는 파일 이름을 사용할 수 있습니다. 예시:

CMyMoniker* pMyMoniker = new CMyMoniker();
pMyMoniker->Open(_T("http://www.microsoft.com"));

- 또는 -

CMyMoniker* pMyMoniker = new CMyMoniker();
pMyMoniker->Open(_T("file:c:\\mydata.dat"));

참고 항목

COleStreamFile 클래스
계층 구조 차트
CAsyncMonikerFile 클래스