IUrlAccessor::GetSecurityDescriptor 方法 (searchapi.h)
取得 URL 專案的安全性描述元。 安全性會在查詢時間套用,因此此描述項會識別讀取存取的安全性。
語法
HRESULT GetSecurityDescriptor(
[out] BYTE *pSD,
[in] DWORD dwSize,
[out] DWORD *pdwLength
);
參數
[out] pSD
類型: BYTE*
接收安全性描述項的指標。
[in] dwSize
類型: DWORD
pSD 陣列的 TCHAR秒大小。
[out] pdwLength
類型: DWORD*
接收寫入 pSD 之 TCHAR 數目的指標,不包括終止 NULL。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
如果使用者不同,這個方法允許註冊至內容來源的使用者與在網域上註冊的使用者之間的自定義對應。 在此方法中建立的安全性描述項必須是自我相對的。
如果 URL 包含使用者安全性識別碼 (SID) ,則會在該使用者的安全性內容中叫用通訊協定處理程式,而且這個方法必須傳回E_NOTIMPL。
如果 URL 不包含使用者 SID,則會在系統服務的安全性內容中叫用通訊協定處理程式。 在此情況下,此方法可以傳回訪問控制清單 (ACL) 來限制讀取存取,或 PRTH_S_ACL_IS_READ_EVERYONE 允許任何人在查詢期間讀取存取。
注意 如果這個方法傳回E_NOTIMPL且 URL 不包含使用者 SID,則該專案可由所有使用者查詢擷取。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 SP1 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | searchapi.h |
可轉散發套件 | Windows 桌面搜尋 (WDS) 3.0 |