OleNoteObjectVisible 함수(ole2.h)

개체를 실행 중 상태로 유지하는 외부 참조를 증가 또는 감소합니다.

구문

HRESULT OleNoteObjectVisible(
  [in] LPUNKNOWN pUnknown,
  [in] BOOL      fVisible
);

매개 변수

[in] pUnknown

잠기거나 잠금 해제할 개체의 IUnknown 인터페이스에 대한 포인터입니다.

[in] fVisible

개체가 표시되는지 여부입니다. TRUE이면 외부 또는 내부 IUnknown::AddRef 및 IUnknown::Release 작업, 등록 또는 해지와 관계없이 개체가 표시되고 활성 상태로 유지되도록 참조 횟수가 증가합니다. FALSE이면 OLE가 보류를 해제하고(참조 횟수 감소) 개체를 닫을 수 있습니다.

반환 값

이 함수는 성공에 대한 S_OK 반환합니다. 다른 가능한 값은 다음과 같습니다.

반환 코드	설명
E_OUTOFMEMORY	작업에 대한 메모리가 부족합니다.
E_INVALIDARG	하나 이상의 매개 변수가 잘못되었습니다.
E_UNEXPECTED	예기치 않은 오류가 발생했습니다.

설명

OleNoteObjectVisible 함수는 CoLockObjectExternal 함수를 호출합니다. 개체가 사용자에게 표시될 때 개체를 잠그고 개체가 보이지 않게 되면 해제할 필요성을 강화하기 위해 별도의 함수로 제공됩니다. 이렇게 하면 사용자를 대신하여 강력한 잠금을 만들어 개체가 표시되는 동안 해당 컨테이너에서 개체를 닫을 수 없도록 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ole2.h
라이브러리	Ole32.lib
DLL	Ole32.dll

추가 정보

CoLockObjectExternal