Metodo IDiscFormat2Erase::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 richiesta.
Valore: 0x8007000E |
|
Uno o più argomenti non sono validi.
Valore: 0x80070057 |
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 cancellazione 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 identifichi il programma che usa questa interfaccia per cancellare i supporti. 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 |