INodeProperties::GetProperty 메서드(mmc.h)

아티클
02/20/2025

GetProperty 메서드는 노드에 대한 텍스트 전용 속성 값을 검색합니다. MMC 2.0 Automation 개체 모델을 기반으로 하는 애플리케이션이 Node.Property 속성을 검색할 때 INodeProperties::GetProperty 메서드의 구현이 호출됩니다.

구문

HRESULT GetProperty(
  [in]  LPDATAOBJECT pDataObject,
  [in]  BSTR         szPropertyName,
  [out] PBSTR        pbstrProperty
);

매개 변수

[in] pDataObject

스냅인 데이터 개체에 대한 포인터입니다.

[in] szPropertyName

검색된 속성의 이름입니다.

[out] pbstrProperty

속성의 텍스트 값입니다.

반환 값

스냅인은 이 메서드를 호출할 때 속성 값을 제공하는 경우 S_OK 반환합니다. 스냅인에서 S_FALSE 반환하면 데이터 개체가 속성 값에 대해 쿼리됩니다.

설명

확장 보기 확장은 두 가지 속성인 CCF_DESCRIPTION 및 CCF_HTML_DETAILS 사용합니다. 데이터 개체를 사용하여 이러한 속성에 대한 값을 제공하여 CCF_DESCRIPTION 쿼리하고 클립보드 형식을 CCF_HTML_DETAILS 대신 스냅인은 INodeProperties::GetProperty 를 사용하여 속성 값을 확장 보기로 반환할 수 있습니다. 이 대안은 스냅인의 데이터 개체가 원하는 정보를 제공하지 않는 경우에 유용합니다.

스냅인은 CCF_DESCRIPTION 및 CCF_HTML_DETAILS 속성 값을 제공하는 것 외에도 INodeProperties를 사용하여 다른 텍스트 기반 속성(예: 새 보기 확장명 포함)에 대한 값을 제공할 수 있습니다.

INodeProperties::GetProperty에 대한 자세한 내용 및 코드 예제는 확장 보기 확장 사용 - 구현 세부 정보를 참조하세요.