IOleObject::GetMiscStatus 메서드(oleidl.h)

아티클
03/01/2024

생성 및 로드 시 개체의 상태 검색합니다.

구문

HRESULT GetMiscStatus(
  [in]  DWORD dwAspect,
  [out] DWORD *pdwStatus
);

매개 변수

[in] dwAspect

상태 정보가 요청되는 개체의 측면입니다. 값은 열거형 DVASPECT에서 가져옵니다.

[out] pdwStatus

상태 정보를 반환할 위치에 대한 포인터입니다. 이 매개 변수는 NULL일 수 없습니다.

반환 값

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

반환 코드	설명
OLE_S_USEREG	기타 상태 정보의 검색을 이 메서드의 기본 처리기 구현에 위임합니다.
CO_E_CLASSNOTREG	개체에 대해 등록된 CLSID가 없습니다.
CO_E_READREGDB	레지스트리에 액세스하는 동안 오류가 발생했습니다.

설명

컨테이너는 개체를 표시하는 방법과 개체가 지원하는 동작 유형을 결정하기 위해 개체를 만들거나 로드할 때 일반적으로 IOleObject::GetMiscStatus 를 호출합니다.

개체는 레지스트리에 상태 정보를 저장합니다. 개체가 실행되고 있지 않으면 기본 처리기의 IOleObject::GetMiscStatus 구현이 레지스트리에서 이 정보를 검색합니다. 개체가 실행 중인 경우 기본 처리기는 개체 자체에서 IOleObject::GetMiscStatus 를 호출합니다.

실제로 레지스트리에 저장된 정보는 개별 개체에 따라 다릅니다. 반환할 상태 값은 열거형 OLEMISC에 정의되어 있습니다.

지정된 DVASPECT에 해당하는 하위 키를 찾을 수 없는 경우 IOleObject::GetMiscStatus의 기본값이 사용됩니다. OLE 컨트롤을 설정하려면 DVASPECT==1을 지정합니다. 이렇게 하면 레지스트리에서 다음이 발생합니다.

HKEY_CLASSES_ROOT\CLSID\ . . .
   MiscStatus = 1

구현자에 대한 참고 사항

구현은 일반적으로 호출을 기본 처리기에 위임하는 것으로 구성됩니다.

요구 사항

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

추가 정보