PSTARTUP_ROUTINE funzione di callback (resapi.h)

Articolo
03/08/2023

Carica una DLL di risorse, restituendo una struttura contenente una tabella di funzione e un numero di versione. Il tipo di PSTARTUP_ROUTINE definisce un puntatore a questa funzione.

Sintassi

PSTARTUP_ROUTINE PstartupRoutine;

DWORD PstartupRoutine(
  [in]  LPCWSTR ResourceType,
  [in]  DWORD MinVersionSupported,
  [in]  DWORD MaxVersionSupported,
  [in]  PSET_RESOURCE_STATUS_ROUTINE SetResourceStatus,
  [in]  PLOG_EVENT_ROUTINE LogEvent,
  [out] PCLRES_FUNCTION_TABLE *FunctionTable
)
{...}

Parametri

[in] ResourceType

Tipo di risorsa avviata.

[in] MinVersionSupported

Versione minima dell'API risorsa supportata dal servizio Cluster.

[in] MaxVersionSupported

Versione massima dell'API risorsa supportata dal servizio Cluster.

[in] SetResourceStatus

Puntatore a una funzione di callback che la DLL di risorse deve chiamare per aggiornarne lo stato dopo aver restituito ERROR_IO_PENDING da Online o Offline. Per altre informazioni, vedere SetResourceStatus.

[in] LogEvent

Puntatore a una funzione di callback che la DLL di risorse deve chiamare per segnalare gli eventi per la risorsa. Per altre informazioni, vedere LogEvent.

[out] FunctionTable

Puntatore a una struttura CLRES_FUNCTION_TABLE che descrive la versione dell'API risorsa e i nomi specifici per i punti di ingresso.

Valore restituito

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	La richiesta è stata completata.
ERROR_REVISION_MISMATCH 1306 (0x51A)	La DLL di risorse non supporta una versione che rientra nell'intervallo identificato dai parametri MinVersionSupported e MaxVersionSupported .

Se l'operazione non è riuscita, l'avvio deve restituire uno dei codici di errore del sistema.

Commenti

La funzione Punto di ingresso di avvio restituisce una tabella di funzioni che descrive sia la versione dell'interfaccia supportata dell'API risorsa che i punti di ingresso per tutte le altre funzioni richieste dalla versione supportata dell'API risorsa.

Attualmente è supportata solo l'API risorsa 1.0.

Se la risorsa supporta più versioni dell'API risorsa, restituire una tabella delle funzioni per la versione più recente. Il numero di versione deve essere minore o uguale al parametro MaxVersionSupported . Se la versione della tabella delle funzioni puntata dal parametro FunctionTable non è compresa nell'intervallo, la risorsa non può essere caricata correttamente.

Per altre informazioni, vedere Implementazione dell'avvio.

Esempio

Vedere Implementazione dell'avvio.

Requisiti


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 Entry-Point dll delle risorse

Condividi tramite