Metodo IBackgroundCopyFile2::SetRemoteName
Modifica il nome remoto in un nuovo URL in un processo di download.
Sintassi
HRESULT SetRemoteName(
[in] LPCWSTR RemoteName
);
Parametri
-
RemoteName [in]
-
Stringa con terminazione Null contenente il nome del file nel server. Per informazioni sulla specifica del nome remoto, vedere il membro RemoteName .
Valore restituito
Questo metodo restituisce i valori restituiti seguenti, nonché altri.
| Codice restituito | Descrizione |
|---|---|
|
Operazione riuscita |
|
Il nuovo nome remoto è un URL non valido o il nuovo URL è troppo lungo (l'URL non può superare i 2.200 caratteri). |
Commenti
In genere, si chiama questo metodo se si desidera modificare l'URL usato per trasferire il file o se si desidera modificare il nome o il percorso del file.
Questo metodo non serializza quando viene restituito. Per serializzare la modifica, sospendere il processo, chiamare questo metodo (se si modificano più file nel processo, usare un ciclo) e riprendere il processo. La chiamata al metodo IBackgroundCopyJob::Resume serializza la modifica.
Se la dimensione del timestamp o del file del nuovo nome remoto è diversa dal nome remoto precedente o il nuovo server non supporta la ripresa del checkpoint (per i nomi remoti HTTP), Ottimizzazione recapito riavvia il download. In caso contrario, il trasferimento riprende dalla stessa posizione nel nuovo server. Ottimizzazione recapito non riavvia i file già trasferiti.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 10 versione 1709 [solo app desktop] |
| Server minimo supportato |
Windows Server, versione 1709 [solo app desktop] |
| Intestazione |
|
| IDL |
|
| Libreria |
|
| DLL |
|
| IID |
IID_IBackgroundCopyFile2 è definito come 83e81b93-0873-474d-8a8c-f2018b1a939c |