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
E_OUTOFMEMORY	Impossibile allocare la memoria necessaria. Valore: 0x8007000E
E_IMAPI_DF2TAO_CLIENT_NAME_IS_NOT_VALID	Il nome del client non è valido. Valore: 0xC0AA050F
E_IMAPI_DF2TAO_WRITE_IN_PROGRESS	Un'operazione di scrittura è in corso. Valore: 0xC0AA0500
E_IMAPI_DF2TAO_MEDIA_IS_PREPARED	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

Vedi anche

IDiscFormat2TrackAtOnce

IDiscFormat2TrackAtOnce::get_ClientName