根據指定的索引鍵,從 COM+ 目錄填入集合中選取的項目清單。
語法
HRESULT PopulateByKey(
[in] SAFEARRAY *psaKeys
);
參數
[in] psaKeys
要讀取資料之物件的 Key 屬性值。
傳回值
這個方法可以傳回標準傳回值E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED和E_FAIL,以及下列值。
| 傳回碼 | 描述 |
|---|---|
|
已成功完成命令。 |
|
存取一或多個物件時發生錯誤。 |
備註
如果您想要儲存擱置的變更,請在呼叫 PopulateByKey 之前呼叫 SaveChanges 方法。 當您呼叫 PopulateByKey 時,對集合所做的未儲存變更會遺失。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | comadmin.h |