IXpsOMPage::GenerateUnusedLookupKey 메서드(xpsobjectmodel.h)

리소스 사전의 리소스에서 조회 키로 사용할 수 있는 고유한 이름을 생성합니다.

구문

HRESULT GenerateUnusedLookupKey(
  [in]          XPS_OBJECT_TYPE type,
  [out, retval] LPWSTR          *key
);

[in] type

조회 키가 생성되는 IXpsOMShareable 개체의 형식입니다.

[out, retval] key

이 메서드에서 생성되는 조회 키 문자열입니다.

메서드가 성공하면 S_OK 반환합니다. 그렇지 않으면 HRESULT 오류 코드가 반환됩니다.

사전에서 고유하기 위해 GenerateUnusedLookupKey 에서 생성된 문자열은 개체 형식을 기반으로 하는 접두사 문자열로 구성되며 그 뒤에 네 개의 고유한 영숫자 문자가 잇습니다.

각 개체 형식에 대한 접두사 문자열은 다음 표에 나와 있습니다.

개체 유형	이 개체 형식의 접두사 문자열
XPS_OBJECT_TYPE_CANVAS	캔버스_
XPS_OBJECT_TYPE_GEOMETRY	형상_
XPS_OBJECT_TYPE_GLYPHS	글리프_
XPS_OBJECT_TYPE_IMAGE_BRUSH	IBrush_
XPS_OBJECT_TYPE_LINEAR_GRADIENT_BRUSH	LGBrush_
XPS_OBJECT_TYPE_MATRIX_TRANSFORM	MTransform_
XPS_OBJECT_TYPE_PATH	경로_
XPS_OBJECT_TYPE_RADIAL_GRADIENT_BRUSH	RGBrush_
XPS_OBJECT_TYPE_SOLID_COLOR_BRUSH	SCBrush_
XPS_OBJECT_TYPE_VISUAL_BRUSH	VBrush_

참고

이 메서드는 이 페이지의 컨텍스트 내에서 고유한 키 문자열을 반환합니다. 둘 이상의 페이지에서 사용할 수 있는 원격 사전 리소스에서 고유한 키를 반환하는 것은 보장되지 않습니다.

이 메서드는 키에 반환되는 문자열에서 사용하는 메모리를 할당합니다. 키가NULL이 아닌 경우 CoTaskMemFree 함수를 사용하여 메모리를 해제합니다.


지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트가 포함된 Windows Vista [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	xpsobjectmodel.h