PONLINE_ROUTINE funzione di callback (resapi.h)

Contrassegna una risorsa come disponibile per l'uso. Il tipo di PONLINE_ROUTINE definisce un puntatore a questa funzione.

Sintassi

PONLINE_ROUTINE PonlineRoutine;

DWORD PonlineRoutine(
  [in]      RESID Resource,
  [in, out] LPHANDLE EventHandle
)
{...}

Parametri

[in] Resource

Identificatore di risorsa per la risorsa da rendere disponibile.

[in, out] EventHandle

In input , EventHandle è NULL. In output , EventHandle contiene un handle per un oggetto di sincronizzazione non firmato. La DLL della risorsa può segnalare questo handle in qualsiasi momento per segnalare un errore di risorsa al Monitoraggio risorse. EventHandle può anche essere impostato su NULL nell'output, che indica che la risorsa non supporta la notifica di eventi asincrona.

Valore restituito

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	L'operazione ha avuto esito positivo e la risorsa è ora online.
ERROR_RESOURCE_NOT_AVAILABLE 5006 (0x138E)	La risorsa è stata arbitata con alcuni altri sistemi e uno degli altri sistemi ha vinto l'arbitrato. Restituisce questo valore solo le risorse in grado di quorum .
ERROR_IO_PENDING 997 (0x3E5)	La richiesta è in sospeso e un thread è stato attivato per elaborare la richiesta online.

 

Se l'operazione non è riuscita per altri motivi, Online deve restituire uno dei codici di errore di sistema.

Commenti

Se la funzione punto di ingresso online restituisce un codice di errore diverso da ERROR_IO_PENDING, Monitoraggio risorse registra un evento e chiama Termina.

La restituzione di un oggetto EventHandle valido restituisce i vantaggi seguenti:

• Monitoraggio risorse non eseguirà il polling LookAlive . Evitare questo sovraccarico è spesso utile, in particolare quando la DLL supporta più istanze di risorse.
• È possibile segnalare l'errore della risorsa in qualsiasi momento segnalando l'handle. Monitoraggio risorse chiamerà immediatamente IsAlive per verificare che la risorsa non sia riuscita.

Per strategie di implementazione efficaci della funzione di ingresso online , vedere Implementazione di online.

Esempio

Vedere Esempi di DLL delle risorse.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Piattaforma di destinazione	Windows
Intestazione	resapi.h

Vedi anche

NetShareAdd

Funzioni Entry-Point dll delle risorse