取得 SYNC_METADATA_FIELD_TYPE_STRING 類型之欄位的值。
HRESULT GetStringValue(
LPWSTR pszValue,
ULONG * pcchValue);
參數
- pszValue
[in, out, unique, size_is(*pcchValue)] 傳回此欄位值。
- pcchValue
[in, out] 指定 pszValue 中的字元數目。如果 pszValue 太小,就傳回擷取此識別碼所需的字元數目,否則就傳回寫入的字元數目。
傳回值
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 中傳回。