ISharedPropertyGroupManager::CreatePropertyGroup 메서드(comsvcs.h)

  • 아티클

새 공유 속성 그룹을 만듭니다. 지정된 이름의 속성 그룹이 이미 있는 경우 CreatePropertyGroup 은 기존 그룹에 대한 참조를 반환합니다.

구문

HRESULT CreatePropertyGroup(
  [in]      BSTR                 Name,
  [in, out] LONG                 *dwIsoMode,
  [in, out] LONG                 *dwRelMode,
  [out]     VARIANT_BOOL         *fExists,
  [out]     ISharedPropertyGroup **ppGroup
);

매개 변수

[in] Name

만들 공유 속성 그룹의 이름입니다.

[in, out] dwIsoMode

새 공유 속성 그룹의 속성에 대한 격리 모드입니다. 아래의 설명에서 상수 표를 참조하세요. 이 메서드에서 반환할 때 fExists 매개 변수의 값이 VARIANT_TRUE 설정되면 입력 값이 무시되고 이 매개 변수에서 반환되는 값은 속성 그룹을 만들 때 할당된 격리 모드입니다.

[in, out] dwRelMode

새 공유 속성 그룹의 속성에 대한 릴리스 모드입니다. 아래의 설명에서 상수 표를 참조하세요. 이 메서드에서 반환할 때 fExists 매개 변수의 값이 VARIANT_TRUE 설정되면 입력 값이 무시되고 이 매개 변수에서 반환되는 값은 속성 그룹을 만들 때 할당된 릴리스 모드입니다.

[out] fExists

이 호출 전에 name 매개 변수에 지정된 공유 속성 그룹이 있고 이 호출에 의해 속성 그룹이 만들어졌는지 VARIANT_FALSE 경우 이 메서드에서 반환할 VARIANT_TRUE.

[out] ppGroup

Name 매개 변수로 식별되는 공유 속성 그룹인 ISharedPropertyGroup에 대한 참조이거나 오류가 발생한 경우 NULL입니다.

반환 값

이 메서드는 다음 값뿐만 아니라 E_OUTOFMEMORY, E_UNEXPECTED 및 E_FAIL 표준 반환 값을 반환할 수 있습니다.

반환 코드 Description
S_OK
 Name 매개 변수에 지정된 공유 속성 그룹에 대한 참조가 ppGroup 매개 변수에 반환됩니다.
CONTEXT_E_NOCONTEXT
COM+에서 호출자가 실행되고 있지 않습니다. 공유 속성 관리자를 사용하려면 COM+에서 호출자가 실행되어야 합니다.
E_INVALIDARG
매개 변수 중 하나 이상이 유효하지 않거나 동일한 개체가 동일한 속성 그룹을 두 번 이상 만들려고 합니다.

설명

다음 상수는 공유 속성 그룹에 대한 유효 격리 모드를 지정하는 데 사용됩니다.

상수 값 Description
LockSetGet 0 기본값입니다. 호출 중에 속성을 잠그면 공유 속성에 대한 모든 가져오기 또는 설정 작업이 원자성임을 보장합니다. 이렇게 하면 두 클라이언트가 동시에 동일한 속성을 읽거나 쓸 수 없지만 다른 클라이언트가 동일한 그룹의 다른 속성에 동시에 액세스하는 것을 방지하지는 않습니다.
LockMethod 1 이 값은 호출자의 현재 메서드가 실행되는 한 호출자가 단독으로 사용하기 위해 공유 속성 그룹의 모든 속성을 잠급니다. 속성 간에 상호 종속성이 있거나 클라이언트가 속성을 읽은 직후에 업데이트해야 다시 액세스할 수 있는 경우에 사용할 수 있는 적절한 모드입니다.
 
참고 격리 모드를 LockMethod로 설정하면 Shared Property Manager에서 호출 개체의 개체 컨텍스트에 액세스해야 합니다. 개체 생성 중에 개체 컨텍스트를 사용할 수 없고 기본 클라이언트에 개체 컨텍스트가 없으므로 이 격리 모드를 사용하여 개체의 생성자 내에서 또는 비 COM+ 개체에서 공유 속성 그룹을 만들 수 없습니다.
 
다음 상수는 공유 속성 그룹에 대한 유효 릴리스 모드를 지정하는 데 사용됩니다.
상수 값 설명
표준 0 기본값입니다. 모든 클라이언트가 속성 그룹에 대한 참조를 해제하면 속성 그룹은 자동으로 제거됩니다.
프로세스 1 속성 그룹은 그 그룹이 만들어진 프로세스가 종료된 후에야 제거됩니다. 속성 그룹에 대한 참조를 보유하는 개체는 참조에서 Release 를 호출해야 합니다.
 
참고 개체는 공유 속성 그룹 참조를 다른 개체에 전달하려고 시도해서는 안 됩니다. 참조가 가져온 개체 외부에서 전달되면 더 이상 유효한 참조가 아닙니다.
 

요구 사항

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

추가 정보

ISharedPropertyGroupManager