IUrlAccessor::GetSecurityDescriptor method (searchapi.h)
Gets the security descriptor for the URL item. Security is applied at query time, so this descriptor identifies security for read access.
Syntax
HRESULT GetSecurityDescriptor(
[out] BYTE *pSD,
[in] DWORD dwSize,
[out] DWORD *pdwLength
);
Parameters
[out] pSD
Type: BYTE*
Receives a pointer to the security descriptor.
[in] dwSize
Type: DWORD
Size in TCHARs of the pSD array.
[out] pdwLength
Type: DWORD*
Receives a pointer to the number of TCHARs written to pSD, not including the terminating NULL.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
This method allows custom mappings between users registered to a content source and those users registered on the domain, if they are different. Security descriptors created in this method must be self-relative.
If the URL contains a user security identifier (SID), then the protocol handler is invoked in the security context of that user, and this method must return E_NOTIMPL.
If the URL does not contain a user SID, then the protocol handler is invoked in the security context of the system service. In that case, this method can return either an access control list (ACL) to restrict read access, or PRTH_S_ACL_IS_READ_EVERYONE to allow anyone read access during querying.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP with SP2, Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2003 with SP1 [desktop apps only] |
| Target Platform | Windows |
| Header | searchapi.h |
| Redistributable | Windows Desktop Search (WDS) 3.0 |