IDiscFormat2RawCD::p ut_ClientName-Methode (imapi2.h)
Legt den Anzeigenamen des Clients fest.
Syntax
HRESULT put_ClientName(
[in] BSTR value
);
Parameter
[in] value
Name der Clientanwendung. Darf nicht NULL oder eine leere Zeichenfolge sein.
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 |
|---|---|
|
Fehler beim Zuordnen des erforderlichen Arbeitsspeichers.
Wert: 0x8007000E |
|
Der Clientname ist ungültig.
Wert: 0xC0AA0604 |
|
Derzeit wird ein Schreibvorgang ausgeführt.
Wert: 0xC0AA0600 |
|
Der angeforderte Vorgang ist ungültig, wenn Medien "vorbereitet", aber nicht freigegeben wurden.
Wert: 0xC0AA0603 |
Hinweise
Der Name wird verwendet, wenn der Schreibvorgang exklusiven Zugriff auf das Gerät anfordert. Die IDiscRecorder2::get_ExclusiveAccessOwner-Eigenschaft enthält den Namen des Clients, der über die Sperre verfügt.
Da jede Anwendung mit Lese-/Schreibzugriff auf das CDROM-Gerät während des Schreibvorgangs den IOCTL_CDROM_EXCLUSIVE_ACCESS -Steuerungscode (Abfrage) verwenden kann (siehe Microsoft Windows Driver Development Kit (DDK)), um auf den Namen zuzugreifen, ist es wichtig, dass der Name das Programm identifiziert, das diese Schnittstelle zum Schreiben auf die Medien verwendet. Der Name ist auf denselben Zeichensatz beschränkt, der für den IOCTL_CDROM_EXCLUSIVE_ACCESS-Steuerelementcode erforderlich ist.
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 |