從目前屬性集讀取指定的屬性。
語法
HRESULT ReadMultiple(
ULONG cpspec,
PROPSPEC const rgpspec,
PROPVARIANT rgvar
);
參數
cpspec
[in] rgpspec 陣列中指定的屬性計數。 如果為零，則方法不會傳回任何屬性，但會以成功程式碼傳回 S_OK。
rgpspec
[in] 要讀取的屬性陣列。 屬性可以透過屬性識別碼或選擇性字串名稱來指定。 不需要以陣列中任何特定順序指定屬性。 陣列可以包含重複的屬性，致使傳回簡單屬性的屬性值重複。 非簡單屬性應該在第二次嘗試開啟時傳回拒絕存取權。 陣列可以包含屬性識別碼和字串識別碼的混合。 此陣列必須至少有 cpspec 個屬性值數目。
rgvar
[in, out] 要填入每個屬性值的 PROPVARIANT 結構陣列(在 Microsoft.VisualStudio.OLE.Interop 命名空間中)。 陣列的大小必須至少是 cpspec 元素。 呼叫端不需要初始化陣列中的值。
傳回值
如果成功，則傳回 S_OK。 如果找不到一或多個屬性，則傳回 S_FALSE。 反之則會傳回錯誤碼。
備註
如果找不到屬性，則 rgvar 陣列中的對應專案包含具有 VT_EMPTY 類型的 VARIANT。