Metodo IWDFRemoteTarget::Reopen (wudfddi.h)

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedere Introduzione con UMDF.]

Il metodo Reopen riaprirà una destinazione di I/O remota dopo la chiusura temporanea.

Sintassi

HRESULT Reopen();

Valore restituito

Riaprire restituisce S_OK se l'operazione ha esito positivo. In caso contrario, il metodo potrebbe restituire il valore seguente:

Questo metodo potrebbe restituire uno degli altri valori che Winerror.h contiene.

Il verificatore del framework segnala un errore se il framework non può aprire il file.

Commenti

In genere, un driver chiama Riapri dall'interno della funzione di callback IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled , ma Riapri può essere chiamato invece dopo il ritorno in OnRemoteTargetRemoveCanceled .

Riaprire usa il nome del file o dell'interfaccia specificato in precedenza in IWDFRemoteTarget::OpenFileByName o IWDFRemoteTarget::OpenRemoteInterface. Se si vuole modificare il file o l'interfaccia usata dal driver, il driver può chiamare IWDFRemoteTarget::Close e quindi può chiamare OpenFileByName o OpenRemoteInterface anziché Riaprire.

Per altre informazioni su Riaprire e su come usare destinazioni di I/O remote nei driver basati su UMDF, vedere Controllo dello stato di una destinazione di I/O generale in UMDF.

Esempio

Nell'esempio di codice seguente viene illustrata una funzione di callback IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled callback che chiama Riapri.

VOID 
STDMETHODCALLTYPE
CMyRemoteTarget::OnRemoteTargetRemoveCanceled(
    __in IWDFRemoteTarget* FxTarget
    )
{
 if (S_OK == (FxTarget->Reopen()))
    {
    //
    // Resume sending I/O requests to the remote target.
    //
    ...
    }
 else
    {
       FxTarget->Close();
    }
}

Requisiti

Vedi anche

IWDFRemoteTarget

IWDFRemoteTarget::Close