OleCreateFontIndirect 함수(olectl.h)
FONTDESC 구조체에서 글꼴 속성에 대한 초기 설명을 사용하여 표준 글꼴 개체를 만들고 초기화합니다. 함수는 riid 매개 변수에서 호출자가 지정한 새 글꼴 개체에 대한 인터페이스 포인터를 반환합니다. QueryInterface 호출은 이 호출의 일부입니다. 호출자는 반환된 인터페이스 포인터를 통해 Release 를 호출합니다.
구문
WINOLECTLAPI OleCreateFontIndirect(
[in] LPFONTDESC lpFontDesc,
[in] REFIID riid,
[out] LPVOID *lplpvObj
);
매개 변수
[in] lpFontDesc
글꼴의 초기 상태를 포함하는 호출자가 할당한 FONTDESC 구조체의 주소입니다. 이 값은 NULL이 아니어야 합니다.
[in] riid
lplpvObj에서 반환할 인터페이스 포인터의 형식을 설명하는 인터페이스의 식별자에 대한 참조입니다.
[out] lplpvObj
riid에서 요청된 인터페이스 포인터를 수신하는 포인터 변수의 주소입니다. 성공적으로 반환되면 이 매개 변수는 새로 만든 글꼴 개체에 대해 요청된 인터페이스 포인터를 포함합니다. 성공하면 호출자는 새 개체가 더 이상 필요하지 않은 경우 이 인터페이스 포인터를 통해 Release를 호출해야 합니다. 실패하면 값이 NULL로 설정됩니다.
반환 값
이 함수는 성공에 대한 S_OK 반환합니다. 다른 가능한 값은 다음과 같습니다.
반환 코드 | 설명 |
---|---|
|
제공된 인터페이스 식별자가 잘못되었습니다. |
|
예기치 않은 오류가 발생했습니다. |
|
작업에 대한 메모리가 부족합니다. |
|
하나 이상의 매개 변수가 잘못되었습니다. |
|
pFontDesc 또는 ppvObj의 주소가 잘못되었습니다. pFontDesc가 NULL로 설정된 경우 함수는 NO_ERROR 반환합니다. |
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | olectl.h |
라이브러리 | OleAut32.lib |
DLL | OleAut32.dll |