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 |