IItemMetadata::TryGetFieldString

Restituisce il valore di un campo di tipo string.

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

Parametri

• pcszFieldName
  [in, string] Nome del campo.

• pszValue
  [in, out, size_is(*pcchValue)] Restituisce il valore del campo specificato.

• pcchValue
  [in, out] Specifica il numero di caratteri in pszValue. Restituisce il numero di caratteri necessari per recuperare il valore del campo specificato se pszValue è troppo piccolo. In caso contrario, restituisce il numero di caratteri scritti, compreso il carattere di terminazione Null.

Valore restituito

• S_OK.

• S_FALSE se il valore non è stato impostato o è stato impostato su NULL.

• E_POINTER.

• E_INVALIDARG.

• SYNC_E_METADATA_FIELD_INVALID_NAME se il campo non esiste.

• SYNC_E_METADATA_FIELD_INVALID_TYPE se il campo non è di tipo string.

• HRESULT_FROM_WIN32 (ERROR_MORE_DATA) se pszValue non è sufficiente per la ricezione del valore del campo. In questo caso, pcchValue restituisce il numero di caratteri necessari.

Osservazioni

I campi personalizzati devono essere definiti tramite una struttura CUSTOM_FIELD_DEFINITION alla prima inizializzazione dei metadati della replica.

Se IItemMetadata::SetFieldString è stato chiamato per impostare il valore del campo, ma la modifica non è ancora stata salvata da una chiamata a IReplicaMetadata::SaveItemMetadata, TryGetFieldString restituisce il valore contenuto nell'oggetto IItemMetadata e non il valore archiviato nell'archivio dei metadati.

Vedere anche

Riferimento

Interfaccia IItemMetadata