IFieldValue::GetStringValue

获取 SYNC_METADATA_FIELD_TYPE_STRING 类型字段的值。

HRESULT GetStringValue(
  LPWSTR pszValue,
  ULONG * pcchValue);

参数

  • pszValue
    [in, out, unique, size_is(*pcchValue)] 返回字段值。
  • pcchValue
    [in, out] 指定 pszValue 中的字符数。如果 pszValue 太小,则返回检索 ID 所需的字符数;否则返回写入的字符数。

返回值

  • S_OK。

  • 如果尚未设置值,则返回值为 S_FALSE。

  • E_POINTER。

  • 如果字段不属于 SYNC_METADATA_FIELD_TYPE_STRING 类型,则返回值为 SYNC_E_METADATA_FIELD_INVALID_TYPE。

  • 如果 pszValue 太小,则返回值为 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在这种情况下,则在 pcchValue 中返回必需的字符数。

请参阅

参考

IFieldValue 接口