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 |
|---|---|
|
L'operazione ha avuto esito positivo e la risorsa è ora online. |
|
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 . |
|
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.
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 |