Startup

The Startup entry point function loads a resource DLL, returning a structure containing a function table and a version number.

DWORD WINAPI Startup(
  LPCWSTR ResourceType,                            
  DWORD MinVersionSupported,                       
  DWORD MaxVersionSupported,                       
  PSET_RESOURCE_STATUS_ROUTINE SetResourceStatus,  
  PLOG_EVENT_ROUTINE LogEvent,                     
  PCLRES_FUNCTION_TABLE * FunctionTable            
);
 

Parameters

ResourceType

[in] Type of resource being started.

MinVersionSupported

[in] Minimum version of the Resource API supported by Cluster Server.

MaxVersionSupported

[in] Maximum version of the Resource API supported by Cluster Server.

SetResourceStatus

[in] Pointer to a callback function that the resource DLL should call to update its status after returning ERROR_IO_PENDING from Online or Offline.

LogEvent

[in] Pointer to a callback function that the resource DLL should call to report events for the resource.

FunctionTable

[out] Pointer to a CLRES_FUNCTION_TABLE structure that describes the Resource API version and the specific names for the entry points.

Return Values

ERROR_SUCCESS

The request was successful.

ERROR_REVISION_MISMATCH.

The resource does not support a version that falls in the range identified by the MinVersionSupported and MaxVersionSupported parameters.

If the operation was unsuccessful, Startup should return a Win32 error value.

Remarks

The Startup entry point function returns a function table that describes:

• The supported interface version of the Resource API.
• Entry points for all other functions required by the supported version of the Resource API.

At present, only Resource API version 1.0 is supported.

Notes to Implementers

If your resource supports more than one version of the Resource API, return a function table for the latest version. The version number should be less than or equal to the MaxVersionSupported parameter. If the version of the function table pointed to by the FunctionTable parameter is not within range, your resource cannot be loaded successfully.

Attempt to make your implementation of Startup finish in less than 300 milliseconds.

QuickInfo

  Version: Use Windows NT Server Enterprise Edition 4.0.
  Windows CE: Unsupported.
  Header: Declared in resapi.h.