Metodo IDiscRecorder::SetRecorderProperties (imapi.h)
Accetta un puntatore IPropertyStorage per un oggetto con tutte le proprietà che l'applicazione desidera modificare. Le impostazioni di tipo sparse sono supportate. È tuttavia consigliabile eseguire una query per un set di proprietà usando GetRecorderProperties, modificare solo le impostazioni di interesse e quindi chiamare SetRecorderProperties per modificare tutti i valori contemporaneamente.
Sintassi
HRESULT SetRecorderProperties(
[in] IPropertyStorage *pPropStg
);
Parametri
[in] pPropStg
Puntatore all'interfaccia IPropertyStorage che il registratore di dischi può usare per recuperare nuove impostazioni in varie proprietà.
Valore restituito
S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:
Commenti
Alcune proprietà sono di sola lettura, ad esempio MaxWriteSpeed. Entrambe le proprietà di sola lettura e le proprietà non supportate vengono ignorate senza generare un errore (vedere IMAPI_S_PROPERTIESIGNORED). Ad esempio, qualcuno potrebbe inviare una proprietà impostata su questa interfaccia e tentare di modificare le proprietà MaxWriteSpeed e ClearlyNeverHeardOfBefore. Poiché MaxWriteSpeed è di sola lettura e ChiaramenteNeverHeardOfBefore è un valore sconosciuto, entrambe le proprietà vengono ignorate e il metodo ha esito positivo.
Dopo aver chiamato SetRecorderProperties, un'applicazione deve verificare le impostazioni delle proprietà chiamando GetRecorderProperties.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | imapi.h |
| Libreria | Uuid.lib |
| DLL | Actxprxy.dll |