CreatePointerMoniker 함수(objbase.h)

개체에 대한 포인터를 기반으로 포인터 모니커를 만듭니다.

구문

HRESULT CreatePointerMoniker(
  [in, optional] LPUNKNOWN punk,
  [out]          LPMONIKER *ppmk
);

[in, optional] punk

결과 모니커로 식별할 개체의 IUnknown 인터페이스에 대한 포인터입니다.

[out] ppmk

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

이 함수는 표준 반환 값 E_OUTOFMEMORY, E_UNEXPECTED 및 S_OK 반환할 수 있습니다.

포인터 모니커는 모니커가 필요한 인터페이스에 전달할 수 있는 기존 인터페이스 포인터를 모니커에 래핑합니다. 포인터 모니커를 사용하면 영구 표현이 없는 개체가 모니커 바인딩 작업에 참여할 수 있습니다.

포인터 모니커가 일반적으로 사용되지 않으므로 이 함수는 자주 호출되지 않습니다.

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