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 |