IMoniker::Hash 메서드(objidl.h)
모니커의 내부 상태를 사용하여 해시 값을 만듭니다.
구문
HRESULT Hash(
[out] DWORD *pdwHash
);
매개 변수
[out] pdwHash
해시 값을 받는 변수에 대한 포인터입니다.
반환 값
이 메서드는 해시 값이 성공적으로 검색되었음을 나타내는 S_OK 반환합니다.
설명
발신자에게 참고 사항
이 메서드에서 반환된 값을 사용하여 모니커의 해시 테이블을 유지할 수 있습니다. 해시 값은 테이블의 해시 버킷을 결정합니다. 이러한 테이블에서 지정된 모니커를 검색하려면 해당 해시 값을 계산한 다음 IMoniker::IsEqual을 사용하여 해당 해시 버킷의 모니커와 비교합니다.구현자에 대한 참고 사항
해시 값은 모니커의 수명 동안 상수여야 합니다. IMoniker::IsEqual을 사용하여 동일하게 비교하는 두 모니커는 동일한 값으로 해시해야 합니다.모니커를 마샬링한 다음, 모니커의 경계를 해제하는 것은 해시 값에 영향을 주지 않아야 합니다. 따라서 IMoniker::Hash 구현은 메모리 주소가 아닌 모니커의 내부 상태에만 의존해야 합니다.
구현별 참고 사항
| 구현 | 참고 |
|---|---|
| 안티 모니커 | 이 메서드는 모니커에 대한 해시 값을 계산합니다. |
| 클래스 모니커 | 이 메서드는 모니커의 해시 값을 계산하고 S_OK 반환합니다. pdwHash가 잘못된 포인터인 경우 E_INVALIDARG 반환할 수 있습니다. |
| 파일 모니커 | 이 메서드는 모니커에 대한 해시 값을 계산합니다. |
| 제네릭 복합 모니커 | 이 메서드는 모니커에 대한 해시 값을 계산합니다. |
| 항목 모니커 | 이 메서드는 모니커에 대한 해시 값을 계산합니다. |
| OBJREF 모니커 | 이 메서드는 모니커에 대한 해시 값을 계산합니다. |
| 포인터 모니커 | 이 메서드는 모니커에 대한 해시 값을 계산합니다. |
| URL 모니커 | 모니커의 URL 문자열을 기반으로 해시 값을 만듭니다. 이 해시 값은 URL 문자열이 동일할 때 동일하지만 다른 URL 문자열에 대해서도 동일할 수 있습니다. 이 메서드는 IMoniker::IsEqual을 호출하는 데 필요한 시간을 줄여 비교 속도를 높이기 위해 사용됩니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | objidl.h |