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。其他可能的值包括下列專案。

傳回碼	Description
E_NOINTERFACE	提供的介面標識碼無效。
E_UNEXPECTED	已發生未預期的錯誤。
E_OUTOFMEMORY	作業的記憶體不足。
E_INVALIDARG	一或多個參數無效。
E_POINTER	pFontDesc 或 ppvObj 中的地址無效。請注意，如果 pFontDesc 設定為 NULL，函式會傳回NO_ERROR。