IDiscRecorder：：SetRecorderProperties 方法 (imapi.h)

接受物件的 IPropertyStorage 指標，其中包含應用程式想要變更的所有屬性。 支援疏鬆設定。 不過，建議您使用 GetRecorderProperties查詢屬性集、只修改感興趣的設定，然後呼叫 SetRecorderProperties 以同時變更所有值。

語法

HRESULT SetRecorderProperties(
  [in] IPropertyStorage *pPropStg
);

參數

[in] pPropStg

磁片錄製器可用來擷取各種屬性之新設定的 IPropertyStorage 介面指標。

傳回值

S_OK會在成功時傳回，但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回，但不代表唯一可能的錯誤值：

備註

某些屬性是唯讀的，例如 MaxWriteSpeed。 唯讀屬性和不支援的屬性都會被忽略，而不會產生錯誤 (請參閱IMAPI_S_PROPERTIESIGNORED) 。 例如，有人可以提交設定為此介面的屬性，並嘗試變更 MaxWriteSpeed 和 ClearlyNeverHeardOfBefore 屬性。 由於 MaxWriteSpeed 是唯讀的，而且 ClearlyNeverHeardOfBefore 是未知的值，因此會忽略這兩個屬性，而且方法會成功。

呼叫 SetRecorderProperties之後，應用程式應該藉由呼叫 GetRecorderProperties來驗證屬性設定。

需求

另請參閱

IDiscRecorder