PSPropertyBag_WritePropertyKey 함수(propsys.h)

속성 모음에서 속성의 속성 키 값을 설정합니다.

구문

PSSTDAPI PSPropertyBag_WritePropertyKey(
  [in] IPropertyBag   *propBag,
  [in] LPCWSTR        propName,
  [in] REFPROPERTYKEY value
);

[in] propBag

속성이 저장되는 속성 모음을 나타내는 IPropertyBag 개체에 대한 포인터입니다.

[in] propName

형식: LPCWSTR

null로 종료된 속성 이름 문자열입니다.

[in] value

형식: REFPROPERTYKEY

속성에 저장할 속성 키 값을 지정하는 PROPERTYKEY 구조체입니다.

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

속성 키는 속성을 고유하게 식별합니다. 예를 들어 PKEY_Keywords는 System.Keywords에 해당합니다. 이 함수는 속성 스키마의 일부로 등록된 속성에 대해서만 성공합니다.

속성 모음 속성 함수 API는 속성 모음에서 값을 표현하는 데 사용되는 WINDOW 형식과 VARIANT 형식 간에 변환됩니다. 이렇게 하면 속성 모음 사용이 용이하고, 애플리케이션이 간소화되며, 일반적인 코딩 오류가 발생하지 않습니다.