IRunningObjectTable::Revoke 메서드(objidl.h)
이전에 IRunningObjectTable::Register를 호출하여 등록한 ROT(실행 중인 개체 테이블)에서 항목을 제거합니다.
구문
HRESULT Revoke(
[in] DWORD dwRegister
);
매개 변수
[in] dwRegister
해지할 ROT 항목의 식별자입니다.
반환 값
이 메서드는 E_INVALIDARG 및 S_OK 표준 반환 값을 반환할 수 있습니다.
설명
이 메서드는 IRunningObjectTable::Register 호출의 효과를 실행 취소하여 모니커와 해당 모니커로 식별된 개체에 대한 포인터를 모두 제거합니다.
발신자에게 참고 사항
모니커 공급자(다른 사용자가 액세스할 수 있도록 개체를 식별하는 모니커를 나눠주기)는 Revoke 메서드를 호출하여 실행이 중지되면 해당 개체의 등록을 취소해야 합니다. 이전에 IRunningObjectTable::Register 를 호출하고 해당 메서드에서 반환된 식별자를 저장해야 합니다. Revoke를 호출할 때 해당 식별자를 사용합니다.가장 일반적인 모니커 공급자 유형은 복합 문서 링크 원본입니다. 여기에는 문서(또는 문서의 일부)에 대한 연결을 지원하는 서버 애플리케이션과 문서 내의 포함에 대한 연결을 지원하는 컨테이너 애플리케이션이 포함됩니다. 연결을 지원하지 않는 서버 애플리케이션은 ROT를 사용하여 포함에 대한 연결을 지원하는 컨테이너 애플리케이션과 협력할 수도 있습니다.
컨테이너 애플리케이션을 작성하는 경우 문서를 닫을 때 문서 등록을 해지해야 합니다. 또한 이름이 바뀔 때 다시 등록하기 전에 문서의 등록을 해지해야 합니다.
서버 애플리케이션을 작성하는 경우 개체가 닫혀 있을 때 개체 등록을 취소해야 합니다. 또한 컨테이너 문서의 이름이 바뀔 때 개체의 등록을 다시 등록하기 전에 취소해야 합니다( IOleObject::SetMoniker 참조).
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | objidl.h |