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*
종료 NULL을 포함하지 않고 pSD에 기록된TCHAR 수에 대한 포인터를 받습니다.
반환 값
형식: 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 |
| 재배포 가능 파일 | WDS(Windows 데스크톱 검색) 3.0 |