IUrlAccessor3::GetImpersonationSidBlobs 方法 (searchapi.h)
擷取指定 URL 的使用者安全性識別碼陣列 (SID) 。 這個方法可讓通訊協定處理常式指定哪些使用者可以存取檔案和搜尋通訊協定主機來模擬使用者,以編制檔案索引。
語法
HRESULT GetImpersonationSidBlobs(
[in] LPCWSTR pcwszURL,
[out] DWORD *pcSidCount,
[out] BLOB **ppSidBlobs
);
參數
[in] pcwszURL
類型: LPCWSTR
代表模擬使用者存取的 URL。
[out] pcSidCount
類型: DWORD*
接收 ppSidBlobs中傳回之使用者 SID 數目的指標。
[out] ppSidBlobs
類型: BLOB**
接收候選模擬使用者 SID 陣列指標的位址。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
如果檔案已加密,這個方法會識別誰可以解密和存取檔案。 如果方法無法識別此資訊,它會失敗,錯誤碼E_ACCESSDENIED。
此方法假設 IUrlAccessor2 物件無法初始化並傳回 程式碼PRTH_S_TRY_IMPERSONATING。 然後,搜尋通訊協定主機會呼叫此方法來擷取用於模擬的 SID 清單,並使用 IUrlAccessor2還原為 ,並在開啟專案時模擬其中一個允許的使用者。
模擬使用者不會提高呼叫者的許可權。 如果呼叫端無法直接擷取授權存取資源的使用者清單,呼叫端將無法使用此方法執行此動作。 只有搜尋通訊協定主機和索引子具有足夠的許可權,可模擬目前登入的使用者。
需求
最低支援的用戶端 | Windows XP with SP2、Windows Vista with SP2 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 SP1 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | searchapi.h |
可轉散發套件 | Windows 搜尋 (WS) 4.0 |