IDiscRecorder::SetRecorderProperties-Methode (imapi.h)
Akzeptiert einen IPropertyStorage-Zeiger für ein Objekt mit allen Eigenschaften, die die Anwendung ändern möchte. Sparseeinstellungen werden unterstützt. Es wird jedoch empfohlen, einen Eigenschaftensatz mithilfe von GetRecorderProperties abzufragen, nur die einstellungen von Interesse zu ändern und dann SetRecorderProperties aufzurufen, um alle Werte gleichzeitig zu ändern.
Syntax
HRESULT SetRecorderProperties(
[in] IPropertyStorage *pPropStg
);
Parameter
[in] pPropStg
Zeiger auf die IPropertyStorage-Schnittstelle , die der Discrecorder verwenden kann, um neue Einstellungen für verschiedene Eigenschaften abzurufen.
Rückgabewert
S_OK wird bei Erfolg zurückgegeben, aber andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Vorgangsfehlern zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:
Hinweise
Einige Eigenschaften sind schreibgeschützt, z. B. MaxWriteSpeed. Sowohl schreibgeschützte Eigenschaften als auch nicht unterstützte Eigenschaften werden ignoriert, ohne einen Fehler zu generieren (siehe IMAPI_S_PROPERTIESIGNORED). Beispielsweise könnte jemand eine Eigenschaft an diese Schnittstelle übermitteln und versuchen, die Eigenschaften MaxWriteSpeed und ClearlyNeverHeardOfBefore zu ändern. Da MaxWriteSpeed schreibgeschützt und ClearlyNeverHeardOfBefore ein unbekannter Wert ist, werden beide Eigenschaften ignoriert, und die Methode ist erfolgreich.
Nach dem Aufruf von SetRecorderProperties sollte eine Anwendung die Eigenschafteneinstellungen überprüfen, indem sie GetRecorderProperties aufruft.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imapi.h |
| Bibliothek | Uuid.lib |
| DLL | Actxprxy.dll |