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

지정된 인덱스로 새 공유 속성을 만듭니다. 지정된 인덱스가 있는 공유 속성이 이미 있는 경우 CreatePropertyByPosition 은 기존 인덱스에 대한 참조를 반환합니다.

구문

HRESULT CreatePropertyByPosition(
  [in]  int             Index,
  [out] VARIANT_BOOL    *fExists,
  [out] ISharedProperty **ppProp
);

매개 변수

[in] Index

새 속성이 참조되는 SharedPropertyGroup 개체 내의 숫자 인덱스입니다. 나중에 이 인덱스 를 사용하여 get_PropertyByPosition 메서드를 사용하여 공유 속성을 검색할 수 있습니다.

[out] fExists

부울 값에 대한 참조입니다. 이 메서드에서 반환할 때 fExists 가 VARIANT_TRUE 설정되면 이 호출 전에 Index 에서 지정한 공유 속성이 존재했습니다. VARIANT_FALSE 설정되면 이 호출을 통해 속성이 생성됩니다.

[out] ppProp

Index 매개 변수에 전달된 숫자 인덱스로 식별된 공유 속성 개체에 대한 참조이거나 오류가 발생한 경우 NULL입니다.

반환 값

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

설명

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

CreatePropertyByPosition 메서드를 사용하여 SharedProperty 개체를 만드는 경우 get_PropertyByPosition 메서드를 사용해야만 해당 속성에 액세스할 수 있습니다. 문자열 이름을 동일한 속성에 할당한 다음 get_Property 메서드를 사용하여 액세스할 수 없습니다. 위치별로 속성에 액세스하는 것은 오버헤드가 적기 때문에 문자열 이름을 사용하여 속성에 액세스하는 것보다 빠릅니다.

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

요구 사항

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

추가 정보

ISharedProperty

ISharedPropertyGroup