다음을 통해 공유

IItemMetadata::TryGetFieldString

  • 아티클

문자열 필드의 값을 반환합니다.

HRESULT TryGetFieldString(
  LPCWSTR pcszFieldName,
  LPWSTR pszValue,
  ULONG * pcchValue);

매개 변수

  • pcszFieldName
    [in, string] 필드의 이름입니다.
  • pszValue
    [in, out, size_is(*pcchValue)] 지정된 필드의 값을 반환합니다.
  • pcchValue
    [in, out] pszValue의 문자 수를 지정합니다. pszValue가 너무 작으면 지정된 필드 값을 검색하는 데 필요한 문자 수를 반환하고, 그렇지 않으면 null 종결자를 포함하여 쓴 문자 수를 반환합니다.

반환 값

  • S_OK

  • 값이 설정되지 않았거나 NULL로 설정되었으면 S_FALSE입니다.

  • E_POINTER

  • E_INVALIDARG

  • 필드가 없으면 SYNC_E_METADATA_FIELD_INVALID_NAME입니다.

  • 필드가 문자열이 아니면 SYNC_E_METADATA_FIELD_INVALID_TYPE입니다.

  • pszValue가 너무 작아서 필드 값을 받을 수 없으면 HRESULT_FROM_WIN32(ERROR_MORE_DATA)입니다. 이 경우에는 pcchValue에서 필요한 문자 수를 반환합니다.

주의

복제본 메타데이터를 처음으로 초기화할 때 CUSTOM_FIELD_DEFINITION 구조를 사용하여 사용자 지정 필드를 정의해야 합니다.

IItemMetadata::SetFieldString을 호출하여 필드 값을 설정했지만 아직 IReplicaMetadata::SaveItemMetadata를 호출하여 변경 내용을 저장하지 않은 경우 TryGetFieldString은 메타데이터 저장소에 저장된 값이 아니라 IItemMetadata 개체에 들어 있는 값을 반환합니다.

참고 항목

참조

IItemMetadata 인터페이스