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

추가 정보

Imoniker