OLEUICONVERTW 結構 （oledlg.h）
包含 OLE 使用者介面連結庫用來初始化 [轉換] 對話框的資訊，以及關閉對話框時連結庫傳回資訊的空間。
語法
typedef struct tagOLEUICONVERTW {
DWORD cbStruct;
DWORD dwFlags;
HWND hWndOwner;
LPCWSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPCWSTR lpszTemplate;
HRSRC hResource;
CLSID clsid;
CLSID clsidConvertDefault;
CLSID clsidActivateDefault;
CLSID clsidNew;
DWORD dvAspect;
WORD wFormat;
BOOL fIsLinkedObject;
HGLOBAL hMetaPict;
LPWSTR lpszUserType;
BOOL fObjectsIconChanged;
LPWSTR lpszDefLabel;
UINT cClsidExclude;
LPCLSID lpClsidExclude;
} OLEUICONVERTW, *POLEUICONVERTW, *LPOLEUICONVERTW;
成員
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 標頭會將 OLEUICONVERT 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 | oledlg.h |