IPropertySheetProvider：：CreatePropertySheet 方法 (mmc.h)

發行項
03/08/2023

IPropertySheetProvider：：CreatePropertySheet方法會建立屬性工作表框架。

語法

HRESULT CreatePropertySheet(
  [in] LPCWSTR      title,
  [in] boolean      type,
  [in] MMC_COOKIE   cookie,
  [in] LPDATAOBJECT pIDataObjectm,
  [in] DWORD        dwOptions
);

參數

[in] title

包含屬性頁標題之 Null 終止字串的指標。此參數不可為 Null。

[in] type

TRUE 會建立屬性工作表， FALSE 會建立精靈。

[in] cookie

目前選取專案的 Cookie 值。當擴充功能嵌入式管理單元呼叫 CreatePropertySheet 時，這可以是 Null 。

[in] pIDataObjectm

Cookie 資料物件上 IDataObject 介面的指標。如果此參數的值是 Null，MMC 將不會呼叫擴充功能嵌入式管理單元所實作的任何 IExtendPropertySheet2 方法。

[in] dwOptions

值，指定方法呼叫可設定的旗標。參數可以是下列值的組合：

MMC_PSO_NOAPPLYNOW

移除 [立即套用] 按鈕。

MMC_PSO_HASHELP

新增 [說明 ] 按鈕。

MMC_PSO_NO_PROPTITLE

針對精靈忽略。如果是屬性工作表，如果指定此選項，則不會在屬性工作表標題列的開頭插入「Properties for」字組。

MMC_PSO_NEWWIZARDTYPE

使用精靈 97 樣式。

例如，若要建立具有 [說明 ] 按鈕且沒有 [立即套用] 按鈕的屬性工作表，dwOptions 參數應該是 MMC_PSO_NOAPPLYNOW | MMC_PSO_HASHELP 。

傳回值

這個方法可以傳回其中一個值。

備註

這個方法會建立物件，以收集建立屬性工作表所需的所有資訊。如果 CreatePropertySheet 呼叫成功，但發生後續的錯誤，您必須呼叫 IPropertySheetProvider：：Show ( –1， 0) 以釋放物件。在此情況下，可以忽略傳回碼。

在嵌入式管理單元在 呼叫 IPropertySheetProvider：：CreatePropertySheet 中建立屬性工作表，然後選擇性地呼叫 IPropertySheetProvider：：AddPrimaryPages 和 IPropertySheetProvider：：AddExtensionPages、然後決定不要顯示內容表，它應該呼叫 IPropertySheetProvider：：Show ( –1， 0) 刪除屬性工作表並釋放其資源。在此情況下，嵌入式管理單元必須刪除它所建立的屬性頁控制碼。這可以在嵌入式管理單元呼叫 IPropertySheetProvider：：Show ( –1， 0) 之前或之後完成，因為 MMC 不使用屬性頁控制碼。

針對以 MMC 1.1 為目標的嵌入式管理單元，嵌入式管理單元必須在 IDataObject 介面上保留額外的參考，該介面會在 IPropertySheetProvider：：CreatePropertySheet 呼叫中傳遞至 MMC。這個參考必須保留在 IPropertySheetProvider：：CreatePropertySheet 呼叫之前，直到屬性工作表可能關閉且呼叫 IPropertySheetProvider：：Show ( –1， 0) 為止。

需求


最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	mmc.h
Dll	Mmcndmgr.dll

另請參閱

IDataObject

IPropertySheetProvider

IPropertySheetProvider：：Show

共用方式為