ISharedPropertyGroup::CreateProperty 메서드(comsvcs.h)

지정된 이름을 사용하여 새 공유 속성을 만듭니다. 해당 이름의 공유 속성이 이미 있는 경우 CreateProperty 는 기존 속성에 대한 참조를 반환합니다.

구문

HRESULT CreateProperty(
  [in]  BSTR            Name,
  [out] VARIANT_BOOL    *fExists,
  [out] ISharedProperty **ppProp
);

매개 변수

[in] Name

만들 속성의 이름입니다. 나중에 이 이름을 사용하여 get_Property 메서드를 사용하여 이 속성에 대한 참조를 가져올 수 있습니다.

[out] fExists

이 호출 전에 Name 매개 변수에 지정된 공유 속성이 있는 경우 이 메서드에서 반환할 때 VARIANT_TRUE 로 설정된 부울 값에 대한 참조이며, 이 호출에 의해 속성이 만들어졌는지 VARIANT_FALSE.

[out] ppProp

Name 매개 변수에 지정된 이름을 가진 SharedProperty 개체에 대한 참조이거나 오류가 발생한 경우 NULL입니다.

반환 값

이 메서드는 표준 반환 값 E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL 및 S_OK 반환할 수 있습니다.

설명

공유 속성을 만들 때 해당 값은 값이 0인 VT_I4 VARIANT인 기본값으로 설정됩니다.

CreateProperty 메서드를 사용하여 공유 속성을 만드는 경우 get_Property 메서드를 사용하여 해당 속성에 액세스할 수 있습니다. 동일한 속성에 숫자 인덱스 를 할당한 다음 get_PropertyByPosition 메서드를 사용하여 액세스할 수 없습니다.

동일한 공유 속성 그룹에는 이름으로 식별되는 일부 SharedProperty 개체와 위치로 식별되는 일부 SharedProperty 개체가 포함될 수 있습니다.

요구 사항

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

추가 정보

ISharedProperty

ISharedPropertyGroup