Share via


ICDBurn::GetRecorderDriveLetter-Methode (shobjidl.h)

Ruft den Laufwerkbuchstaben eines CD-Laufwerks ab, das als schreibaktiv markiert wurde.

Syntax

HRESULT GetRecorderDriveLetter(
  [out] LPWSTR pszDrive,
  [in]  UINT   cch
);

Parameter

[out] pszDrive

Typ: LPWSTR

Ein Zeiger auf eine Zeichenfolge, die den Laufwerkbuchstaben enthält, z. B. "F:".

[in] cch

Typ: UINT

Die Größe der Zeichenfolge in Zeichen, auf die von pszDrive verwiesen wird. Dieser Wert ist normalerweise 4. Werte, die größer als 4 sind, sind zulässig, aber die zusätzlichen Zeichen werden von dieser Methode ignoriert. Werte kleiner als 4 generieren einen E_INVALIDARG Fehler.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Das Laufwerk, dessen Buchstabenbezeichnung von dieser Methode zurückgegeben wird, ist das Laufwerk, auf dem die Option Cd-Schreibzugriff auf diesem Laufwerk aktivieren ausgewählt ist. Diese Option finden Sie auf dem Eigenschaftenblatt des Laufwerks. Nur auf einem Laufwerk eines Systems kann diese Option ausgewählt sein.

Wenn ein bezeigbares CD-Laufwerk vorhanden ist, diese Option jedoch nicht ausgewählt wurde, gibt die Methode einen Fehlercode zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl.h
DLL Shell32.dll