PRESOURCE_CONTROL_ROUTINE funzione di callback (resapi.h)

Articolo
08/25/2023

Esegue un'operazione che si applica a una risorsa. Il tipo PRESOURCE_CONTROL_ROUTINE definisce un puntatore a questa funzione.

Sintassi

PRESOURCE_CONTROL_ROUTINE PresourceControlRoutine;

DWORD PresourceControlRoutine(
  [in]            RESID Resource,
  [in]            DWORD ControlCode,
  [in, optional]  PVOID InBuffer,
  [in]            DWORD InBufferSize,
  [out, optional] PVOID OutBuffer,
  [in]            DWORD OutBufferSize,
  [out]           LPDWORD BytesReturned
)
{...}

Parametri

[in] Resource

Identificatore della risorsa interessata.

[in] ControlCode

Codice di controllo che rappresenta l'operazione da eseguire. Per un elenco di valori validi per il parametro ControlCode , vedere Codici di controllo del tipo di risorsa.

[in, optional] InBuffer

Puntatore a un buffer contenente dati da usare nell'operazione. InBuffer può essere NULL se non sono necessari dati.

[in] InBufferSize

Dimensioni, in byte, del buffer a cui punta InBuffer.

[out, optional] OutBuffer

Puntatore a un buffer contenente i dati risultanti dall'operazione. OutBuffer può essere NULL se l'operazione non deve restituire dati.

[in] OutBufferSize

Dimensioni, in byte, dello spazio disponibile a cui punta OutBuffer.

[out] BytesReturned

Dimensioni effettive, in byte, dei dati risultanti dall'operazione.

Valore restituito

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	L'operazione associata a ControlCode è stata completata correttamente.
ERROR_INVALID_FUNCTION 1	La DLL della risorsa ha richiesto che Monitoraggio risorse esegua l'elaborazione predefinita (se presente) per ControlCode oltre all'elaborazione fornita dalla DLL (se presente).
ERROR_MORE_DATA 234 (0xEA)	La dimensione allocata di OutBuffer era troppo piccola per contenere i dati richiesti. BytesReturned indica le dimensioni necessarie. Includere sempre il valore NULL di terminazione durante il calcolo delle dimensioni dei byte delle stringhe.
ERROR_RESOURCE_PROPERTIES_STORED 5024 (0x13A0)	Indica che i nuovi valori delle proprietà per una risorsa sono stati impostati nel database cluster, ma le proprietà non sono ancora state applicate. I nuovi valori delle proprietà verranno applicati dopo che la risorsa viene portata offline e portata online.
Codice di errore	L'operazione è stata completata.

Commenti

Alcuni codici di controllo devono essere gestiti dalla DLL della risorsa, mentre altri devono essere lasciati a Monitoraggio risorse. Per strategie di implementazione efficaci della funzione del punto di ingresso ResourceControl , vedere Implementazione di ResourceControl.

Esempio

Vedere Esempi di DLL di 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

Funzioni di Entry-Point DLL delle risorse

Condividi tramite