OLEUICONVERTA 結構 (oledlg.h)
包含 OLE 使用者介面連結庫用來初始化 [轉換 ] 對話框的資訊，以及關閉對話框時連結庫傳回信息的空間。
語法
typedef struct tagOLEUICONVERTA {
DWORD cbStruct;
DWORD dwFlags;
HWND hWndOwner;
LPCSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPCSTR lpszTemplate;
HRSRC hResource;
CLSID clsid;
CLSID clsidConvertDefault;
CLSID clsidActivateDefault;
CLSID clsidNew;
DWORD dvAspect;
WORD wFormat;
BOOL fIsLinkedObject;
HGLOBAL hMetaPict;
LPSTR lpszUserType;
BOOL fObjectsIconChanged;
LPSTR lpszDefLabel;
UINT cClsidExclude;
LPCLSID lpClsidExclude;
} OLEUICONVERTA, *POLEUICONVERTA, *LPOLEUICONVERTA;
成員
cbStruct
結構的大小，以位元組為單位。 此成員必須填入輸入。
dwFlags
在輸入時，此欄位會指定初始化和建立旗標。 結束時，它會指定用戶的選項。 這可能是下列旗標的組合。
hWndOwner
擁有對話框的視窗。 此成員不應為 NULL。
lpszCaption
要作為對話框標題的字串指標。 如果 為 NULL，則連結庫會使用 Convert。
lpfnHook
連結函式的指標，該函式會處理用於對話框的訊息。 攔截函式必須傳回零，才能將它未處理的訊息傳回連結庫中的對話框程式。 攔截函式必須傳回非零值，以防止連結庫的對話框程式處理已經處理的訊息。
lCustData
連結庫傳遞給 lpfnHook 成員所指向之攔截函式的應用程式定義數據。 連結庫會在WM_INITDIALOG訊息的 lParam 參數中傳遞 OLEUICONVERT 結構的指標;這個指標可用來擷取 lCustData 成員。
hInstance
實例，其中包含 lpszTemplate 成員所指定的對話框範本。 如果 lpszTemplate 成員為 NULL 或無效，則會忽略這個成員。
lpszTemplate
Null 終止字串的指標，指定要取代連結庫之 [轉換 ] 對話框範本之對話框範本的資源檔名稱。
hResource
自訂對話框的資源句柄。 如果這個成員是 NULL，則連結庫會使用標準 [轉換 ] 對話框範本，如果它是有效的，則連結庫是由 lpszTemplate 成員命名的範本。
clsid
要轉換或啟動之物件的CLSID。 此成員是在輸入上設定的。
clsidConvertDefault
選取 [轉換為 ] 時，要作為默認類別使用的 CLSID。 如果 dwFlags 成員不包含CF_SETCONVERTDEFAULT，則會忽略此成員。 此成員是在輸入上設定的。
clsidActivateDefault
選取 [ 啟用身 分] 時，要使用的 CLSID 作為預設類別。 如果 dwFlags 成員不包含CF_SETACTIVATEDEFAULT，則會忽略這個成員。 此成員是在輸入上設定的。
clsidNew
所選類別的 CLSID。 這個成員是在輸出上設定的。
dvAspect
對象的層面。 這必須是DVASPECT_CONTENT或DVASPECT_ICON。 如果 dvAspect 在輸入時DVASPECT_ICON，則會核取 [ 顯示身分圖示 ] 方塊，並顯示對象的圖示。 此成員是在輸入和輸出上設定。 如需詳細資訊，請參閱 DVASPECT。
wFormat
要轉換或啟動之物件的數據格式。
fIsLinkedObject
如果對象已連結，則為TRUE。 此成員是在輸入上設定的。
hMetaPict
包含圖示層面的 METAFILEPICT 。 此成員是在輸入和輸出上設定。
lpszUserType
要轉換或啟動之物件的使用者類型名稱指標。 如果此值為 NULL，則對話框會從登錄中擷取使用者類型名稱。 此字串會在結束時釋出。
fObjectsIconChanged
如果對象的圖示已變更，則為TRUE。 (也就是說，如果呼叫 OleUIChangeIcon 且未取消。) 。 這個成員是在輸出上設定的。
lpszDefLabel
要用於圖示的默認標籤指標。 如果 為 NULL，則會使用簡短的使用者類型名稱。 如果對像是連結，呼叫端應該傳遞連結來源的顯示名稱。 這會在結束時釋出。
cClsidExclude
lpClsidExclude 中的 CLSID 數目。
lpClsidExclude
要從清單中排除之 CLSID 清單的指標。
備註
注意
oledlg.h 標頭會根據 UNICODE 預處理器常數的定義，將 OLEUICONVERT 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 | oledlg.h |