Metodo IDiscFormat2TrackAtOnce::p ut_ClientName (imapi2.h)
Imposta il nome descrittivo del client.
Sintassi
HRESULT put_ClientName(
[in] BSTR value
);
Parametri
[in] value
Nome dell'applicazione client.
Valore restituito
S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:
| Codice restituito | Descrizione |
|---|---|
|
Impossibile allocare la memoria necessaria.
Valore: 0x8007000E |
|
Il nome del client non è valido.
Valore: 0xC0AA050F |
|
Un'operazione di scrittura è in corso.
Valore: 0xC0AA0500 |
|
L'operazione richiesta non è valida quando i supporti sono stati "preparati" ma non rilasciati.
Valore: 0xC0AA0503 |
Commenti
Il nome viene usato quando l'operazione di scrittura richiede l'accesso esclusivo al dispositivo. La proprietà IDiscRecorder2::get_ExclusiveAccessOwner contiene il nome del client con il blocco.
Poiché qualsiasi applicazione con accesso in lettura/scrittura al dispositivo CDROM durante l'operazione di scrittura può usare il codice di controllo IOCTL_CDROM_EXCLUSIVE_ACCESS (query) (vedere Microsoft Windows Driver Development Kit (DDK) per accedere al nome, è importante che il nome identifica il programma che usa questa interfaccia per scrivere nel supporto. Il nome è limitato allo stesso set di caratteri richiesto dal codice di controllo IOCTL_CDROM_EXCLUSIVE_ACCESS.
Requisiti
| Client minimo supportato | Windows Vista, Windows XP con SP2 [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | imapi2.h |