Freigeben über

IFileSystemImage::p ut_VolumeName-Methode (imapi2fs.h)

  • Artikel

Legt den Volumenamen für dieses Dateisystemimage fest.

Syntax

HRESULT put_VolumeName(
  [in] BSTR newVal
);

Parameter

[in] newVal

Zeichenfolge, die den Volumenamen für dieses Dateisystemimage enthält.

Rückgabewert

S_OK wird bei Erfolg zurückgegeben, aber als Ergebnis der Implementierung können andere Erfolgscodes zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode Beschreibung
IMAPI_E_INVALID_VOLUME_NAME
 Der für den Parameter %1!ls! angegebene Wert ist ungültig.

Wert: 0xC0AAB101

Hinweise

Die Zeichenfolge ist auf 15 Zeichen beschränkt. Für ISO 9660-Datenträger kann der Volumename die folgenden Zeichen verwenden:

  • "A" bis "Z"
  • "0" bis "9"
  • "_" (Unterstrich)
Für Joliet- und UDF-Datenträger kann der Volumename die folgenden Zeichen verwenden:
  • "a" bis "z"
  • "A" bis "Z"
  • "0" bis "9"
  • "." (Punkt)
  • "_" (Unterstrich)
Wenn Sie keinen Volumenamen angeben, wird ein Standardvolumename mit dem Systemdatum und der Systemzeit generiert, zu dem das Ergebnisobjekt erstellt wird.

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 imapi2fs.h

Weitere Informationen

IFileSystemImage

IFileSystemImage::get_ImportedVolumeName

IFileSystemImage::get_VolumeName