CreateFileMoniker 함수(objbase.h)

지정된 경로를 기반으로 파일 모니커를 만듭니다.

구문

HRESULT CreateFileMoniker(
  [in]  LPCOLESTR lpszPathName,
  [out] LPMONIKER *ppmk
);

매개 변수

[in] lpszPathName

이 모니커의 기반이 되는 경로입니다.

이 매개 변수는 상대 경로, UNC 경로 또는 드라이브 문자 기반 경로를 지정할 수 있습니다. 상대 경로를 기반으로 하는 경우 바인딩되기 전에 결과 모니커를 다른 파일 모니커에 구성해야 합니다.

[out] ppmk

새 파일 모니커에 대한 인터페이스 포인터를 수신하는 IMoniker* 포인터 변수의 주소입니다. 성공하면 함수가 파일 모니커에서 AddRef 를 호출하고 호출자는 Release를 호출합니다. 오류가 발생하면 인터페이스 포인터의 값은 NULL입니다.

반환 값

이 함수는 E_OUTOFMEMORY 표준 반환 값과 다음 값을 반환할 수 있습니다.

반환 코드	Description
S_OK	모니커가 성공적으로 만들어졌습니다.
MK_E_SYNTAX	경로 구문에 오류가 발생했습니다.

설명

CreateFileMoniker 는 파일에 저장된 개체에 대한 모니커를 만듭니다. 모니커 공급자(다른 개체에 모니커를 제공하는 개체)는 이 함수를 호출하여 모니커를 만들어 제어하는 파일 기반 개체를 식별한 다음 이 모니커에 대한 포인터를 다른 개체에서 사용할 수 있도록 할 수 있습니다. 파일 모니커로 식별되는 개체는 파일 모니커가 바인딩될 때 로드할 수 있도록 IPersistFile 인터페이스도 구현해야 합니다.

파일 기반 문서에만 연결을 지원하는 OLE 서버 애플리케이션과 같이 각 개체가 자체 파일에 있는 경우 파일 모니커는 필요한 유일한 유형의 모니커입니다. 파일보다 작은 개체를 식별하려면 모니커 공급자가 파일 모니커 외에도 다른 유형의 모니커(예: 항목 모니커)를 사용하여 복합 모니커를 만들어야 합니다. 문서보다 작은 개체(예: 문서 섹션 또는 포함된 개체)에 대한 연결을 지원하는 OLE 서버 애플리케이션에서는 복합 모니커가 필요합니다.

첫 번째 모니커가 절대 경로를 기반으로 하고 다른 모니커가 상대 경로인 경우 파일 모니커는 다른 파일 모니커의 오른쪽에만 구성될 수 있으며, 그 결과 두 경로의 조합에 따라 단일 파일 모니커가 생성됩니다. 다른 모니커의 오른쪽에 구성된 모니커는 해당 모니커의 구체화여야 하며 파일 모니커는 가장 큰 스토리지 단위를 나타냅니다. 파일 내에 저장된 개체를 식별하려면 파일 모니커 오른쪽에 다른 유형의 모니커(일반적으로 항목 모니커)를 작성합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	objbase.h
라이브러리	Ole32.lib
DLL	Ole32.dll
API 세트	ext-ms-win-com-ole32-l1-1-4(Windows 10 버전 10.0.14393에 도입됨)

추가 정보

Imoniker