IOleUndoManager::D iscardFrom 메서드(ocidl.h)
실행 취소 관리자에게 실행 취소 또는 다시 실행 스택에서 지정한 실행 취소 단위와 그 아래의 모든 실행 취소 단위를 취소하도록 지시합니다.
구문
HRESULT DiscardFrom(
[in] IOleUndoUnit *pUU
);
매개 변수
[in] pUU
삭제할 실행 취소 단위에 대한 IOleUndoUnit 포인터입니다. 이 매개 변수는 전체 실행 취소 또는 다시 실행 스택을 삭제하는 NULL 일 수 있습니다. 매개 변수가 NULL 이 아니면 스택이 삭제되지 않습니다.
반환 값
이 메서드는 성공에 대한 S_OK 반환합니다. 가능한 다른 반환 값은 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
지정된 실행 취소 단위를 스택에서 찾을 수 없습니다. |
|
실행 취소 관리자를 사용할 수 없습니다. |
설명
실행 취소 관리자는 먼저 지정된 단위에 대한 실행 취소 스택을 검색하고, 찾을 수 없는 경우 다시 실행 스택을 검색합니다. 검색된 후 지정된 단위와 동일한 스택의 해당 단위 아래에 있는 모든 항목이 삭제됩니다. 실행 취소 단위는 IOleParentUndoUnit::FindUnit을 호출하여 결정된 대로 실행 취소 관리자에 포함된 부모 단위의 자식일 수 있습니다. 자식 단위인 경우 지정된 단위를 포함하는 루트 단위와 해당 스택의 해당 단위 아래에 있는 모든 단위가 삭제됩니다.
열린 부모 단위가 있고 DiscardFrom 메서드가 호출되고 pUU 매개 변수가 NULL인 경우 실행 취소 관리자는 IOleUndoManager::Close 를 먼저 호출하지 않고 열린 부모 단위를 즉시 해제하고 삭제해야 합니다. 부모 단위를 연 개체가 닫히려고 하면 IOleUndoManager::Close 가 S_FALSE 반환합니다. 부모 단위가 열려 있는 경우 해당 단위를 버리고 스택을 삭제합니다. 부모 단위가 열려 있지 않으면 스택을 버리기만 하면됩니다. pUU 매개 변수가 NULL이 아니면 열려 있는 부모 단위를 열어 두어야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | ocidl.h |