Metodo IDiscFormat2Data::p ut_ClientName (imapi2.h)

Articolo
03/14/2023

Imposta il nome descrittivo del client.

Sintassi

HRESULT put_ClientName(
  [in] BSTR value
);

Parametri

[in] value

Nome dell'applicazione client. Non può essere NULL o una stringa vuota.

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_IMAPI_DF2DATA_CLIENT_NAME_IS_NOT_VALID	Il nome del client non è valido. Valore: 0xC0AA0211
E_IMAPI_DF2DATA_WRITE_IN_PROGRESS	Attualmente è in corso un'operazione di scrittura. Valore: 0xC0AA0500

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 identifichi 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

Requisito	Valore
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

IDiscFormat2Data

IDiscFormat2Data::get_ClientName

Condividi tramite