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 中返回必需的字符数。