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
E_OUTOFMEMORY	Impossibile allocare la memoria richiesta. Valore: 0x8007000E
E_INVALIDARG	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

Vedi anche

IDiscFormat2Erase

IDiscFormat2Erase::get_ClientName