Condividi tramite


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