IRawCDImageCreator::get_MediaCatalogNumber-Methode (imapi2.h)
Legt die Medienkatalognummer (Media Catalog Number, MCN) für den gesamten Audiodatenträger fest.
Syntax
HRESULT get_MediaCatalogNumber(
[out] BSTR *value
);
Parameter
[out] value
Zeiger auf einen BSTR-Wert , der den aktuellen MCN darstellt, der dem Audiodatenträger zugeordnet ist.
Rückgabewert
S_OK wird bei Erfolg zurückgegeben, aber andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden.
Hinweise
Der von dieser Methode zurückgegebene MCN ist als 13-stellige Dezimalzahl formatiert und muss auch von der IRawCDImageCreator::p ut_MediaCatalogNumber-Methode in derselben Form bereitgestellt werden. Darüber hinaus muss der bereitgestellte MCN-Wert, der über IRawCDImageCreator::p ut_MediaCatalogNumber bereitgestellt wird, eine gültige Prüfsummenziffer (geringste signifikante Ziffer) aufweisen, sonst wird er abgelehnt. Um die Kompatibilität mit Skripts zu verbessern, können führende Nullen ausgeschlossen werden. Beispielsweise kann "0123456789012" als "123456789012" ausgedrückt werden.
Details zum MCN-Wert finden Sie in der MMC-Spezifikation.
Diese Methode wird in Windows Server 2003 mit Service Pack 1 (SP1), Windows XP mit Service Pack 2 (SP2) und Windows Vista über das Windows Feature Pack for Storage unterstützt. Alle Features dieses Updatepakets werden in Windows 7 und Windows Server 2008 R2 nativ unterstützt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imapi2.h |