IPropertyNotifySink::OnRequestEdit 메서드(ocidl.h)

requestedit 속성이 변경하려고 했음을 싱크에 알 수 있습니다.

구문

HRESULT OnRequestEdit(
  [in] DISPID dispID
);

매개 변수

[in] dispID

변경하려는 속성의 디스패치 식별자이거나 여러 속성이 변경하려고 하는 경우 DISPID_UNKNOWN.

반환 값

이 메서드는 다음 값을 반환할 수 있습니다.

반환 코드 Description
S_OK
지정된 속성 또는 속성을 변경할 수 있습니다.
S_FALSE
지정된 속성 또는 속성을 변경할 수 없습니다. 호출자는 새 속성 값을 삭제하여 이 반환 값을 준수해야 합니다. 이는 [requestedit] 특성 및 이 메서드의 계약의 일부입니다.

설명

싱크는 변경이 수행되도록 허용하거나 허용하지 않도록 선택할 수 있습니다. 예를 들어 싱크는 속성에 읽기 전용 상태를 적용할 수 있습니다. DISPID_UNKNOWN 여러 속성이 변경하려고 함을 나타내는 이 메서드의 유효한 매개 변수입니다. 이 경우 싱크는 싱크가 인식하지 않는 특정 속성을 포함하여 개체의 모든 [requestedit] 속성에 대해 전역 읽기 전용 상태를 적용할 수 있습니다.

싱크에서 변경을 허용하는 경우 개체는 [requestedit] 외에도 [바인딩 가능]으로 표시된 속성에 대해 IPropertyNotifySink::OnChanged 알림을 만들어야 합니다.

이 메서드는 어떤 종류의 데이터 유효성 검사도 구현하는 데 사용할 수 없습니다. 호출 시 속성의 원하는 새 값을 사용할 수 없으므로 유효성을 검사할 수 없습니다. 이 메서드의 유일한 목적은 싱크가 속성에 읽기 전용 상태를 적용하도록 허용하는 것입니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 ocidl.h

추가 정보

IPropertyNotifySink