Metodo IBackgroundCopyJob::SetDisplayName (bits.h)

Specifica un nome visualizzato per il processo. In genere, si usa il nome visualizzato per identificare il processo in un'interfaccia utente.

Sintassi

HRESULT SetDisplayName(
  [in] LPCWSTR Val
);

Parametri

[in] Val

Stringa con terminazione Null che identifica il processo. Non deve essere NULL. La lunghezza della stringa è limitata a 256 caratteri, senza includere il carattere di terminazione Null.

Valore restituito

Questo metodo restituisce i valori HRESULT seguenti, nonché altri.

Codice restituito	Descrizione
S_OK	Il nome visualizzato è stato impostato correttamente.
E_INVALIDARG	Il parametro pDisplayName non può essere NULL o il nome supera i 256 caratteri.
BG_E_STRING_TOO_LONG	Il nome visualizzato supera i 256 caratteri.
BG_E_INVALID_STATE	Lo stato del processo non può essere BG_JOB_STATE_CANCELLED o BG_JOB_STATE_ACKNOWLEDGED.

Commenti

Il nome visualizzato viene originariamente impostato quando si crea il processo. Per informazioni dettagliate sulla specifica del nome visualizzato quando si crea il processo, vedere il metodo IBackgroundCopyManager::CreateJob .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP
Server minimo supportato	Windows Server 2003
Piattaforma di destinazione	Windows
Intestazione	bits.h
Libreria	Bits.lib
DLL	QmgrPrxy.dll

Vedi anche

IBackgroundCopyJob::GetDisplayName

IBackgroundCopyManager::CreateJob