Windows编程

开发平台：
Visual C++

SMBSMP.C：源码内容
							/*++
Copyright (c) 1997 <company name>
Module Name:
    SmbSmp.c
Abstract:
    Resource DLL for SMB Sample (SmbSmp).
Author:
    <user> (<email-name>) Mmmm DD, 1997
Revision History:
--*/
#pragma comment(lib, "clusapi.lib")
#pragma comment(lib, "resutils.lib")
#pragma comment(lib, "advapi32.lib")
#pragma comment(lib, "netapi32.lib")
#define UNICODE 1
#pragma warning( disable : 4115 )  // named type definition in parentheses
#pragma warning( disable : 4201 )  // nonstandard extension used : nameless struct/union
#pragma warning( disable : 4214 )  // nonstandard extension used : bit field types other than int
#include <windows.h>
#pragma warning( default : 4214 )  // nonstandard extension used : bit field types other than int
#pragma warning( default : 4201 )  // nonstandard extension used : nameless struct/union
#pragma warning( default : 4115 )  // named type definition in parentheses
#include <clusapi.h>
#include <resapi.h>
#include <stdio.h>
#include <lm.h>
#include <lmerr.h>
//
// Type and constant definitions.
//
#define SMBSMP_RESNAME  L"SMB Sample"
#define SMBSMP_SVCNAME  TEXT("LanmanServer")
#define DBG_PRINT printf
// ADDPARAM: Add new parameters here.
#define PARAM_NAME__SHARENAME L"ShareName"
#define PARAM_NAME__PATH L"Path"
#define PARAM_NAME__REMARK L"Remark"
// ADDPARAM: Add new parameters here.
typedef struct _SMBSMP_PARAMS {
    PWSTR           ShareName;
    PWSTR           Path;
    PWSTR           Remark;
} SMBSMP_PARAMS, *PSMBSMP_PARAMS;
typedef struct _SMBSMP_RESOURCE {
    RESID                   ResId; // for validation
    SMBSMP_PARAMS         Params;
    HKEY                    ParametersKey;
    RESOURCE_HANDLE         ResourceHandle;
    LPWSTR                  ResourceName;
    CLUS_WORKER             OnlineThread;
    CLUSTER_RESOURCE_STATE  State;
} SMBSMP_RESOURCE, *PSMBSMP_RESOURCE;
//
// Global data.
//
// Event Logging routine.
PLOG_EVENT_ROUTINE g_LogEvent = NULL;
// Resource Status routine for pending Online and Offline calls.
PSET_RESOURCE_STATUS_ROUTINE g_SetResourceStatus = NULL;
// Forward reference to our RESAPI function table.
extern CLRES_FUNCTION_TABLE g_SmbSmpFunctionTable;
//
// SMB Sample resource read-write private properties.
//
RESUTIL_PROPERTY_ITEM
SmbSmpResourcePrivateProperties[] = {
    { PARAM_NAME__SHARENAME, NULL, CLUSPROP_FORMAT_SZ, 0, 0, 0, RESUTIL_PROPITEM_REQUIRED, FIELD_OFFSET(SMBSMP_PARAMS,ShareName) },
    { PARAM_NAME__PATH, NULL, CLUSPROP_FORMAT_SZ, 0, 0, 0, RESUTIL_PROPITEM_REQUIRED, FIELD_OFFSET(SMBSMP_PARAMS,Path) },
    { PARAM_NAME__REMARK, NULL, CLUSPROP_FORMAT_SZ, 0, 0, 0, 0, FIELD_OFFSET(SMBSMP_PARAMS,Remark) },
    { 0 }
};
//
// Function prototypes.
//
DWORD
WINAPI
Startup(
    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
    );
RESID
WINAPI
SmbSmpOpen(
    IN LPCWSTR ResourceName,
    IN HKEY ResourceKey,
    IN RESOURCE_HANDLE ResourceHandle
    );
VOID
WINAPI
SmbSmpClose(
    IN RESID ResourceId
    );
DWORD
WINAPI
SmbSmpOnline(
    IN RESID ResourceId,
    IN OUT PHANDLE EventHandle
    );
DWORD
WINAPI
SmbSmpOnlineThread(
    PCLUS_WORKER WorkerPtr,
    IN PSMBSMP_RESOURCE ResourceEntry
    );
DWORD
WINAPI
SmbSmpOffline(
    IN RESID ResourceId
    );
VOID
WINAPI
SmbSmpTerminate(
    IN RESID ResourceId
    );
DWORD
SmbSmpDoTerminate(
    IN PSMBSMP_RESOURCE ResourceEntry
    );
BOOL
WINAPI
SmbSmpLooksAlive(
    IN RESID ResourceId
    );
BOOL
WINAPI
SmbSmpIsAlive(
    IN RESID ResourceId
    );
BOOL
SmbSmpCheckIsAlive(
    IN PSMBSMP_RESOURCE ResourceEntry
    );
DWORD
WINAPI
SmbSmpResourceControl(
    IN RESID ResourceId,
    IN DWORD ControlCode,
    IN PVOID InBuffer,
    IN DWORD InBufferSize,
    OUT PVOID OutBuffer,
    IN DWORD OutBufferSize,
    OUT LPDWORD BytesReturned
    );
DWORD
SmbSmpGetPrivateResProperties(
    IN OUT PSMBSMP_RESOURCE ResourceEntry,
    OUT PVOID OutBuffer,
    IN DWORD OutBufferSize,
    OUT LPDWORD BytesReturned
    );
DWORD
SmbSmpValidatePrivateResProperties(
    IN OUT PSMBSMP_RESOURCE ResourceEntry,
    IN const PVOID InBuffer,
    IN DWORD InBufferSize,
    OUT PSMBSMP_PARAMS Params
    );
DWORD
SmbSmpSetPrivateResProperties(
    IN OUT PSMBSMP_RESOURCE ResourceEntry,
    IN const PVOID InBuffer,
    IN DWORD InBufferSize
    );

BOOLEAN
WINAPI
DllMain(
    IN HINSTANCE    DllHandle,
    IN DWORD        Reason,
    IN LPVOID       Reserved
    )
/*++
Routine Description:
    Main DLL entry point.
Arguments:
    DllHandle - DLL instance handle.
    Reason - Reason for being called.
    Reserved - Reserved argument.
Return Value:
    TRUE - Success.
    FALSE - Failure.
--*/
{
    switch( Reason ) {
    case DLL_PROCESS_ATTACH:
        DisableThreadLibraryCalls( DllHandle );
        break;
    case DLL_PROCESS_DETACH:
        break;
    }
    return(TRUE);
} // DllMain

DWORD
WINAPI
Startup(
    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
    )
/*++
Routine Description:
    Startup the resource DLL. This routine verifies that at least one
    currently supported version of the resource DLL is between
    MinVersionSupported and MaxVersionSupported. If not, then the resource
    DLL should return ERROR_REVISION_MISMATCH.
    If more than one version of the resource DLL interface is supported by
    the resource DLL, then the highest version (up to MaxVersionSupported)
    should be returned as the resource DLL's interface. If the returned
    version is not within range, then startup fails.
    The ResourceType is passed in so that if the resource DLL supports more
    than one ResourceType, it can pass back the correct function table
    associated with the ResourceType.
Arguments:
    ResourceType - The type of resource requesting a function table.
    MinVersionSupported - The minimum resource DLL interface version 
        supported by the cluster software.
    MaxVersionSupported - The maximum resource DLL interface version
        supported by the cluster software.
    SetResourceStatus - Pointer to a routine that the resource DLL should 
        call to update the state of a resource after the Online or Offline 
        routine returns a status of ERROR_IO_PENDING.
    LogEvent - Pointer to a routine that handles the reporting of events 
        from the resource DLL. 
    FunctionTable - Returns a pointer to the function table defined for the
        version of the resource DLL interface returned by the resource DLL.
Return Value:
    ERROR_SUCCESS - The operation was successful.
    ERROR_MOD_NOT_FOUND - The resource type is unknown by this DLL.
    ERROR_REVISION_MISMATCH - The version of the cluster service doesn't
        match the versrion of the DLL.
    Win32 error code - The operation failed.
--*/
{
    if ( (MinVersionSupported > CLRES_VERSION_V1_00) ||
         (MaxVersionSupported < CLRES_VERSION_V1_00) ) {
        return(ERROR_REVISION_MISMATCH);
    }
    if ( lstrcmpiW( ResourceType, SMBSMP_RESNAME ) != 0 ) {
        return(ERROR_MOD_NOT_FOUND);
    }
    if ( !g_LogEvent ) {
        g_LogEvent = LogEvent;
        g_SetResourceStatus = SetResourceStatus;
    }
    *FunctionTable = &g_SmbSmpFunctionTable;
    return(ERROR_SUCCESS);
} // Startup

RESID
WINAPI
SmbSmpOpen(
    IN LPCWSTR ResourceName,
    IN HKEY ResourceKey,
    IN RESOURCE_HANDLE ResourceHandle
    )
/*++
Routine Description:
    Open routine for SMB Sample resources.
    Open the specified resource (create an instance of the resource). 
    Allocate all structures necessary to bring the specified resource 
    online.
Arguments:
    ResourceName - Supplies the name of the resource to open.
    ResourceKey - Supplies handle to the resource's cluster configuration 
        database key.
    ResourceHandle - A handle that is passed back to the resource monitor 
        when the SetResourceStatus or LogEvent method is called. See the 
        description of the SetResourceStatus and LogEvent methods on the
        SmbSmpStatup routine. This handle should never be closed or used
        for any purpose other than passing it as an argument back to the
        Resource Monitor in the SetResourceStatus or LogEvent callback.
Return Value:
    RESID of created resource.
    NULL on failure.
--*/
{
    DWORD               status;
    DWORD               disposition;
    RESID               resid = 0;
    HKEY                parametersKey = NULL;
    PSMBSMP_RESOURCE resourceEntry = NULL;
    //
    // Open the Parameters registry key for this resource.
    //
    status = ClusterRegCreateKey( ResourceKey,
                                  L"Parameters",
                                  0,
                                  KEY_ALL_ACCESS,
                                  NULL,
                                  &parametersKey,
                                  &disposition );
    if ( status != ERROR_SUCCESS ) {
        (g_LogEvent)(
            ResourceHandle,
            LOG_ERROR,
            L"Unable to open Parameters key. Error: %1!u!.n",
            status );
        goto exit;
    }
    //
    // Allocate a resource entry.
    //
    resourceEntry = (PSMBSMP_RESOURCE) LocalAlloc( LMEM_FIXED, sizeof(SMBSMP_RESOURCE) );
    if ( resourceEntry == NULL ) {
        status = GetLastError();
        (g_LogEvent)(
            ResourceHandle,
            LOG_ERROR,
            L"Unable to allocate resource entry structure. Error: %1!u!.n",
            status );
        goto exit;
    }
    //
    // Initialize the resource entry..
    //
    ZeroMemory( resourceEntry, sizeof(SMBSMP_RESOURCE) );
    resourceEntry->ResId = (RESID)resourceEntry; // for validation
    resourceEntry->ResourceHandle = ResourceHandle;
    resourceEntry->ParametersKey = parametersKey;
    resourceEntry->State = ClusterResourceOffline;
    //
    // Save the name of the resource.
    //
    resourceEntry->ResourceName = LocalAlloc( LMEM_FIXED, (lstrlenW( ResourceName ) + 1) * sizeof(WCHAR) );
    if ( resourceEntry->ResourceName == NULL ) {
        goto exit;
    }
    lstrcpyW( resourceEntry->ResourceName, ResourceName );
    //
    // Startup for the resource.
    //
    // TODO: Add your resource startup code here.
    resid = (RESID)resourceEntry;
exit:
    if ( resid == 0 ) {
        if ( parametersKey != NULL ) {
            ClusterRegCloseKey( parametersKey );
        }
        if ( resourceEntry != NULL ) {
            LocalFree( resourceEntry->ResourceName );
            LocalFree( resourceEntry );
        }
    }
    if ( status != ERROR_SUCCESS ) {
        SetLastError( status );
    }
    return(resid);
} // SmbSmpOpen

VOID
WINAPI
SmbSmpClose(
    IN RESID ResourceId
    )
/*++
Routine Description:
    Close routine for SMB Sample resources.
    Close the specified resource and deallocate all structures, etc.,
    allocated in the Open call. If the resource is not in the offline state,
    then the resource should be taken offline (by calling Terminate) before
    the close operation is performed.
Arguments:
    ResourceId - Supplies the RESID of the resource to close.
Return Value:
    None.
--*/
{
    PSMBSMP_RESOURCE resourceEntry;
    resourceEntry = (PSMBSMP_RESOURCE)ResourceId;
    if ( resourceEntry == NULL ) {
        DBG_PRINT( "SmbSmp: Close request for a nonexistent resource id %un",
                   ResourceId );
        return;
    }
    if ( resourceEntry->ResId != ResourceId ) {
        (g_LogEvent)(
            resourceEntry->ResourceHandle,
            LOG_ERROR,
            L"Close resource sanity check failed! ResourceId = %1!u!.n",
            ResourceId );
        return;
    }
#ifdef LOG_VERBOSE
    (g_LogEvent)(
        resourceEntry->ResourceHandle,
        LOG_INFORMATION,
        L"Close request.n" );
#endif
    //
    // Close the Parameters key.
    //
    if ( resourceEntry->ParametersKey ) {
        ClusterRegCloseKey( resourceEntry->ParametersKey );
    }
    //
    // Deallocate the resource entry.
    //
    // ADDPARAM: Add new parameters here.
    LocalFree( resourceEntry->Params.ShareName );
    LocalFree( resourceEntry->Params.Path );
    LocalFree( resourceEntry->Params.Remark );
    LocalFree( resourceEntry->ResourceName );
    LocalFree( resourceEntry );
} // SmbSmpClose

DWORD
WINAPI
SmbSmpOnline(
    IN RESID ResourceId,
    IN OUT PHANDLE EventHandle
    )
/*++
Routine Description:
    Online routine for SMB Sample resources.
    Bring the specified resource online (available for use). The resource
    DLL should attempt to arbitrate for the resource if it is present on a
    shared medium, like a shared SCSI bus.
Arguments:
    ResourceId - Supplies the resource id for the resource to be brought 
        online (available for use).
    EventHandle - Returns a signalable handle that is signaled when the 
        resource DLL detects a failure on the resource. This argument is 
        NULL on input, and the resource DLL returns NULL if asynchronous 
        notification of failures is not supported, otherwise this must be 
        the address of a handle that is signaled on resource failures.
Return Value:
    ERROR_SUCCESS - The operation was successful, and the resource is now 
        online.
    ERROR_RESOURCE_NOT_FOUND - RESID is not valid.
    ERROR_RESOURCE_NOT_AVAILABLE - If the resource was arbitrated with some 
        other systems and one of the other systems won the arbitration.
    ERROR_IO_PENDING - The request is pending, a thread has been activated 
        to process the online request. The thread that is processing the 
        online request will periodically report status by calling the 
        SetResourceStatus callback method, until the resource is placed into 
        the ClusterResourceOnline state (or the resource monitor decides to 
        timeout the online request and Terminate the resource. This pending 
        timeout value is settable and has a default value of 3 minutes.).
    Win32 error code - The operation failed.
--*/
{
    PSMBSMP_RESOURCE resourceEntry = NULL;
    DWORD               status;
    resourceEntry = (PSMBSMP_RESOURCE)ResourceId;
    if ( resourceEntry == NULL ) {
        DBG_PRINT( "SmbSmp: Online request for a nonexistent resource id %u.n",
                   ResourceId );
        return(ERROR_RESOURCE_NOT_FOUND);
    }
    if ( resourceEntry->ResId != ResourceId ) {
        (g_LogEvent)(
            resourceEntry->ResourceHandle,
            LOG_ERROR,
            L"Online service sanity check failed! ResourceId = %1!u!.n",
            ResourceId );
        return(ERROR_RESOURCE_NOT_FOUND);
    }
#ifdef LOG_VERBOSE
    (g_LogEvent)(
        resourceEntry->ResourceHandle,
        LOG_INFORMATION,
        L"Online request.n" );
#endif
    resourceEntry->State = ClusterResourceOffline;
    ClusWorkerTerminate( &resourceEntry->OnlineThread );
    status = ClusWorkerCreate( &resourceEntry->OnlineThread,
                               SmbSmpOnlineThread,
                               resourceEntry );
    if ( status != ERROR_SUCCESS ) {
        resourceEntry->State = ClusterResourceFailed;
        (g_LogEvent)(
            resourceEntry->ResourceHandle,
            LOG_ERROR,
            L"Online: Unable to start thread, status %1!u!.n",
            status
            );
    } else {
        status = ERROR_IO_PENDING;
    }
    return(status);
} // SmbSmpOnline

DWORD
WINAPI
SmbSmpOnlineThread(
    PCLUS_WORKER WorkerPtr,
    IN PSMBSMP_RESOURCE ResourceEntry
    )
/*++
Routine Description:
    Worker function which brings a resource from the resource table online.
    This function is executed in a separate thread.
Arguments:
    WorkerPtr - Supplies the worker structure
    ResourceEntry - A pointer to the SMBSMP_RESOURCE block for this resource.
Returns:
    ERROR_SUCCESS - The operation completed successfully.
    
    Win32 error code - The operation failed.
--*/
{
    RESOURCE_STATUS     resourceStatus;
    DWORD               status;
    LPWSTR              nameOfPropInError;
    SHARE_INFO_2        shareInfo;
    resourceStatus.ResourceState = ClusterResourceFailed;
    resourceStatus.WaitHint = 0;
    resourceStatus.CheckPoint = 1;
    //
    // Read parameters.
    //
    status = ResUtilGetPropertiesToParameterBlock( ResourceEntry->ParametersKey,
                                                   SmbSmpResourcePrivateProperties,
                                                   (LPBYTE) &ResourceEntry->Params,
                                                   TRUE, // CheckForRequiredProperties
                                                   &nameOfPropInError );
    if ( status != ERROR_SUCCESS ) {
        (g_LogEvent)(
            ResourceEntry->ResourceHandle,
            LOG_ERROR,
            L"Unable to read the '%1' property. Error: %2!u!.n",
            (nameOfPropInError == NULL ? L"" : nameOfPropInError),
            status );
        goto exit;
    }
    //
    // Start the SmbSmp service
    //
    status = ResUtilStartResourceService( SMBSMP_SVCNAME, NULL );
    if ( status == ERROR_SERVICE_ALREADY_RUNNING ) {
        status = ERROR_SUCCESS;
    } else if ( status != ERROR_SUCCESS ) {
        goto exit;
    }
    //
    // Bring the resource online.
    //
    // TODO: Add code to bring your resource online.
    if ( status == ERROR_SUCCESS ) {
        shareInfo.shi2_netname =      ResourceEntry->Params.ShareName;
        shareInfo.shi2_type =         STYPE_DISKTREE;
        shareInfo.shi2_remark =       ResourceEntry->Params.Remark;
        shareInfo.shi2_permissions =  ACCESS_ALL;
        shareInfo.shi2_max_uses =     (DWORD)-1;
        shareInfo.shi2_current_uses = 0;
        shareInfo.shi2_path =         ResourceEntry->Params.Path;
        shareInfo.shi2_passwd =       NULL;
        status = NetShareAdd( NULL, 2, (PBYTE)&shareInfo, NULL );
        if ( status != ERROR_SUCCESS ) {
            (g_LogEvent)(
                ResourceEntry->ResourceHandle,
                LOG_ERROR,
                L"Error creating share '%1'. Error: %2!u!.n",
                ResourceEntry->Params.ShareName,
                status );
            goto exit;
        }
    }
exit:
    if ( status != ERROR_SUCCESS ) {
        (g_LogEvent)(
            ResourceEntry->ResourceHandle,
            LOG_ERROR,
            L"Error %1!u! bringing resource online.n",
            status );
    } else {
        resourceStatus.ResourceState = ClusterResourceOnline;
    }
    // _ASSERTE(g_SetResourceStatus != NULL);
    g_SetResourceStatus( ResourceEntry->ResourceHandle, &resourceStatus );
    ResourceEntry->State = resourceStatus.ResourceState;
    return(status);
} // SmbSmpOnlineThread

DWORD
WINAPI
SmbSmpOffline(
    IN RESID ResourceId
    )
/*++
Routine Description:
    Offline routine for SMB Sample resources.
    Take the specified resource offline gracefully (unavailable for use).  
    Wait for any cleanup operations to complete before returning.
Arguments:
    ResourceId - Supplies the resource id for the resource to be shutdown 
        gracefully.
Return Value:
    ERROR_SUCCESS - The request completed successfully and the resource is 
        offline.
    ERROR_RESOURCE_NOT_FOUND - RESID is not valid.
    ERROR_IO_PENDING - The request is still pending, a thread has been 
        activated to process the offline request. The thread that is 
        processing the offline will periodically report status by calling 
        the SetResourceStatus callback method, until the resource is placed 
        into the ClusterResourceOffline state (or the resource monitor decides 
        to timeout the offline request and Terminate the resource).
    
    Win32 error code - Will cause the resource monitor to log an event and 
        call the Terminate routine.
--*/
{
    PSMBSMP_RESOURCE resourceEntry;
    resourceEntry = (PSMBSMP_RESOURCE)ResourceId;
    if ( resourceEntry == NULL ) {
        DBG_PRINT( "SmbSmp: Offline request for a nonexistent resource id %un",
            ResourceId );
        return(ERROR_RESOURCE_NOT_FOUND);
    }
    if ( resourceEntry->ResId != ResourceId ) {
        (g_LogEvent)(
            resourceEntry->ResourceHandle,
            LOG_ERROR,
            L"Offline resource sanity check failed! ResourceId = %1!u!.n",
            ResourceId );
        return(ERROR_RESOURCE_NOT_FOUND);
    }
#ifdef LOG_VERBOSE
    (g_LogEvent)(
        resourceEntry->ResourceHandle,
        LOG_INFORMATION,
        L"Offline request.n" );
#endif
    // TODO: Offline code
    // NOTE: Offline should try to shut the resource down gracefully, whereas
    // Terminate must shut the resource down immediately. If there are no
    // differences between a graceful shut down and an immediate shut down,
    // Terminate can be called for Offline, as it is below.  However, if there
    // are differences, replace the call to Terminate below with your graceful
    // shutdown code.
    //
    // Terminate the resource.
    //
    return SmbSmpDoTerminate( resourceEntry );
} // SmbSmpOffline

VOID
WINAPI
SmbSmpTerminate(
    IN RESID ResourceId
    )
/*++
Routine Description:
    Terminate routine for SMB Sample resources.
    Take the specified resource offline immediately (the resource is
    unavailable for use).
Arguments:
    ResourceId - Supplies the resource id for the resource to be brought 
        offline.
Return Value:
    None.
--*/
{
    PSMBSMP_RESOURCE resourceEntry;
    resourceEntry = (PSMBSMP_RESOURCE)ResourceId;
    if ( resourceEntry == NULL ) {
        DBG_PRINT( "SmbSmp: Terminate request for a nonexistent resource id %un",
            ResourceId );
        return;
    }
    if ( resourceEntry->ResId != ResourceId ) {
        (g_LogEvent)(
            resourceEntry->ResourceHandle,
            LOG_ERROR,
            L"Terminate resource sanity check failed! ResourceId = %1!u!.n",
            ResourceId );
        return;
    }
#ifdef LOG_VERBOSE
    (g_LogEvent)(
        resourceEntry->ResourceHandle,
        LOG_INFORMATION,
        L"Terminate request.n" );
#endif
    //
    // Terminate the resource.
    //
    SmbSmpDoTerminate( resourceEntry );
    resourceEntry->State = ClusterResourceOffline;
} // SmbSmpTerminate

DWORD
SmbSmpDoTerminate(
    IN PSMBSMP_RESOURCE ResourceEntry
    )
/*++
Routine Description:
    Do the actual Terminate work for SMB Sample resources.
Arguments:
    ResourceEntry - Supplies resource entry for resource to be terminated
Return Value:
    ERROR_SUCCESS - The request completed successfully and the resource is 
        offline.
    Win32 error code - Will cause the resource monitor to log an event and 
        call the Terminate routine.
--*/
{
    DWORD       status = ERROR_SUCCESS;
    //
    // Kill off any pending threads.
    //
    ClusWorkerTerminate( &ResourceEntry->OnlineThread );
    //
    // Terminate the resource.
    //
    // TODO: Add code to terminate your resource.
    status = NetShareDel( NULL, ResourceEntry->Params.ShareName, 0 );
    if ( status != NO_ERROR ) {
        (g_LogEvent)(
            ResourceEntry->ResourceHandle,
            LOG_ERROR,
            L"Error removing share '%1'. Error %2!u!.n",
            ResourceEntry->Params.ShareName,
            status );
    } else {
        ResourceEntry->State = ClusterResourceOffline;
    }
    return(status);
} // SmbSmpDoTerminate

BOOL
WINAPI
SmbSmpLooksAlive(
    IN RESID ResourceId
    )
/*++
Routine Description:
    LooksAlive routine for SMB Sample resources.
    Perform a quick check to determine if the specified resource is probably
    online (available for use).  This call should not block for more than
    300 ms, preferably less than 50 ms.
Arguments:
    ResourceId - Supplies the resource id for the resource to polled.
Return Value:
    TRUE - The specified resource is probably online and available for use.
    FALSE - The specified resource is not functioning normally.
--*/
{
    PSMBSMP_RESOURCE  resourceEntry;
    resourceEntry = (PSMBSMP_RESOURCE)ResourceId;
    if ( resourceEntry == NULL ) {
        DBG_PRINT("SmbSmp: LooksAlive request for a nonexistent resource id %un",
            ResourceId );
        return(FALSE);
    }
    if ( resourceEntry->ResId != ResourceId ) {
        (g_LogEvent)(
            resourceEntry->ResourceHandle,
            LOG_ERROR,
            L"LooksAlive sanity check failed! ResourceId = %1!u!.n",
            ResourceId );
        return(FALSE);
    }
#ifdef LOG_VERBOSE
    (g_LogEvent)(
        resourceEntry->ResourceHandle,
        LOG_INFORMATION,
        L"LooksAlive request.n" );
#endif
    // TODO: LooksAlive code
    // NOTE: LooksAlive should be a quick check to see if the resource is
    // available or not, whereas IsAlive should be a thorough check.  If
    // there are no differences between a quick check and a thorough check,
    // IsAlive can be called for LooksAlive, as it is below.  However, if there
    // are differences, replace the call to IsAlive below with your quick
    // check code.
    //
    // Check to see if the resource is alive.
    //
    return(SmbSmpCheckIsAlive( resourceEntry ));
} // SmbSmpLooksAlive

BOOL
WINAPI
SmbSmpIsAlive(
    IN RESID ResourceId
    )
/*++
Routine Description:
    IsAlive routine for SMB Sample resources.
    Perform a thorough check to determine if the specified resource is online
    (available for use). This call should not block for more than 400 ms,
    preferably less than 100 ms.
Arguments:
    ResourceId - Supplies the resource id for the resource to polled.
Return Value:
    TRUE - The specified resource is online and functioning normally.
    FALSE - The specified resource is not functioning normally.
--*/
{
    PSMBSMP_RESOURCE  resourceEntry;
    resourceEntry = (PSMBSMP_RESOURCE)ResourceId;
    if ( resourceEntry == NULL ) {
        DBG_PRINT("SmbSmp: IsAlive request for a nonexistent resource id %un",
            ResourceId );
        return(FALSE);
    }
    if ( resourceEntry->ResId != ResourceId ) {
        (g_LogEvent)(
            resourceEntry->ResourceHandle,
            LOG_ERROR,
            L"IsAlive sanity check failed! ResourceId = %1!u!.n",
            ResourceId );
        return(FALSE);
    }
#ifdef LOG_VERBOSE
    (g_LogEvent)(
        resourceEntry->ResourceHandle,
        LOG_INFORMATION,
        L"IsAlive request.n" );
#endif
    //
    // Check to see if the resource is alive.
    //
    return(SmbSmpCheckIsAlive( resourceEntry ));
} // SmbSmpIsAlive

BOOL
SmbSmpCheckIsAlive(
    IN PSMBSMP_RESOURCE ResourceEntry
    )
/*++
Routine Description:
    Check to see if the resource is alive for SMB Sample resources.
Arguments:
    ResourceEntry - Supplies the resource entry for the resource to polled.
Return Value:
    TRUE - The specified resource is online and functioning normally.
    FALSE - The specified resource is not functioning normally.
--*/
{
    SHARE_INFO_2        shareInfo;
    DWORD               status;
    //
    // Check to see if the resource is alive.
    //
    // TODO: Add code to determine if your resource is alive.
    status = NetShareGetInfo( NULL,
                              ResourceEntry->Params.ShareName,
                              2, // return a SHARE_INFO_2 structure
                              (LPBYTE *) &shareInfo );
    if ( status == NERR_NetNameNotFound ) {
        (g_LogEvent)(
            ResourceEntry->ResourceHandle,
            LOG_ERROR,
            L"Error, share '%1' went away.n",
            ResourceEntry->Params.ShareName );
        return(FALSE);
    } else if ( status != ERROR_SUCCESS ) {
        (g_LogEvent)(
            ResourceEntry->ResourceHandle,
            LOG_ERROR,
            L"Error checking for share '%1'. Error %2!u!.n",
            ResourceEntry->Params.ShareName,
            status );
    }
    return(TRUE);
} // SmbSmpCheckIsAlive

DWORD
WINAPI
SmbSmpResourceControl(
    IN RESID ResourceId,
    IN DWORD ControlCode,
    IN PVOID InBuffer,
    IN DWORD InBufferSize,
    OUT PVOID OutBuffer,
    IN DWORD OutBufferSize,
    OUT LPDWORD BytesReturned
    )
/*++
Routine Description:
    ResourceControl routine for SMB Sample resources.
    Perform the control request specified by ControlCode on the specified
    resource.
Arguments:
    ResourceId - Supplies the resource id for the specific resource.
    ControlCode - Supplies the control code that defines the action
        to be performed.
    InBuffer - Supplies a pointer to a buffer containing input data.
    InBufferSize - Supplies the size, in bytes, of the data pointed
        to by InBuffer.
    OutBuffer - Supplies a pointer to the output buffer to be filled in.
    OutBufferSize - Supplies the size, in bytes, of the available space
        pointed to by OutBuffer.
    BytesReturned - Returns the number of bytes of OutBuffer actually
        filled in by the resource. If OutBuffer is too small, BytesReturned
        contains the total number of bytes for the operation to succeed.
Return Value:
    ERROR_SUCCESS - The function completed successfully.
    ERROR_RESOURCE_NOT_FOUND - RESID is not valid.
    ERROR_INVALID_FUNCTION - The requested control code is not supported.
        In some cases, this allows the cluster software to perform the work.
    Win32 error code - The function failed.
--*/
{
    DWORD               status;
    PSMBSMP_RESOURCE  resourceEntry;
    DWORD               required;
    resourceEntry = (PSMBSMP_RESOURCE)ResourceId;
    if ( resourceEntry == NULL ) {
        DBG_PRINT("SmbSmp: ResourceControl request for a nonexistent resource id %un",
            ResourceId );
        return(ERROR_RESOURCE_NOT_FOUND);
    }
    if ( resourceEntry->ResId != ResourceId ) {
        (g_LogEvent)(
            resourceEntry->ResourceHandle,
            LOG_ERROR,
            L"ResourceControl sanity check failed! ResourceId = %1!u!.n",
            ResourceId );
        return(ERROR_RESOURCE_NOT_FOUND);
    }
    switch ( ControlCode ) {
        case CLUSCTL_RESOURCE_UNKNOWN:
            *BytesReturned = 0;
            status = ERROR_SUCCESS;
            break;
        case CLUSCTL_RESOURCE_ENUM_PRIVATE_PROPERTIES:
            status = ResUtilEnumProperties( SmbSmpResourcePrivateProperties,
                                            OutBuffer,
                                            OutBufferSize,
                                            BytesReturned,
                                            &required );
            if ( status == ERROR_MORE_DATA ) {
                *BytesReturned = required;
            }
            break;
        case CLUSCTL_RESOURCE_GET_PRIVATE_PROPERTIES:
            status = SmbSmpGetPrivateResProperties( resourceEntry,
                                                      OutBuffer,
                                                      OutBufferSize,
                                                      BytesReturned );
            break;
        case CLUSCTL_RESOURCE_VALIDATE_PRIVATE_PROPERTIES:
            status = SmbSmpValidatePrivateResProperties( resourceEntry,
                                                           InBuffer,
                                                           InBufferSize,
                                                           NULL );
            break;
        case CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES:
            status = SmbSmpSetPrivateResProperties( resourceEntry,
                                                      InBuffer,
                                                      InBufferSize );
            break;
        default:
            status = ERROR_INVALID_FUNCTION;
            break;
    }
    return(status);
} // SmbSmpResourceControl

DWORD
WINAPI
SmbSmpResourceTypeControl(
    IN LPCWSTR ResourceTypeName,
    IN DWORD ControlCode,
    IN PVOID InBuffer,
    IN DWORD InBufferSize,
    OUT PVOID OutBuffer,
    IN DWORD OutBufferSize,
    OUT LPDWORD BytesReturned
    )
/*++
Routine Description:
    ResourceTypeControl routine for SMB Sample resources.
    Perform the control request specified by ControlCode.
Arguments:
    ResourceTypeName - Supplies the name of the resource type.
    ControlCode - Supplies the control code that defines the action
        to be performed.
    InBuffer - Supplies a pointer to a buffer containing input data.
    InBufferSize - Supplies the size, in bytes, of the data pointed
        to by InBuffer.
    OutBuffer - Supplies a pointer to the output buffer to be filled in.
    OutBufferSize - Supplies the size, in bytes, of the available space
        pointed to by OutBuffer.
    BytesReturned - Returns the number of bytes of OutBuffer actually
        filled in by the resource. If OutBuffer is too small, BytesReturned
        contains the total number of bytes for the operation to succeed.
Return Value:
    ERROR_SUCCESS - The function completed successfully.
    ERROR_INVALID_FUNCTION - The requested control code is not supported.
        In some cases, this allows the cluster software to perform the work.
    Win32 error code - The function failed.
--*/
{
    DWORD               status;
    DWORD               required;
    switch ( ControlCode ) {
        case CLUSCTL_RESOURCE_TYPE_UNKNOWN:
            *BytesReturned = 0;
            status = ERROR_SUCCESS;
            break;
        case CLUSCTL_RESOURCE_TYPE_ENUM_PRIVATE_PROPERTIES:
            status = ResUtilEnumProperties( SmbSmpResourcePrivateProperties,
                                            OutBuffer,
                                            OutBufferSize,
                                            BytesReturned,
                                            &required );
            if ( status == ERROR_MORE_DATA ) {
                *BytesReturned = required;
            }
            break;
        default:
            status = ERROR_INVALID_FUNCTION;
            break;
    }
    return(status);
} // SmbSmpResourceTypeControl

DWORD
SmbSmpGetPrivateResProperties(
    IN OUT PSMBSMP_RESOURCE ResourceEntry,
    OUT PVOID OutBuffer,
    IN DWORD OutBufferSize,
    OUT LPDWORD BytesReturned
    )
/*++
Routine Description:
    Processes the CLUSCTL_RESOURCE_GET_PRIVATE_PROPERTIES control function
    for resources of type SMB Sample.
Arguments:
    ResourceEntry - Supplies the resource entry on which to operate.
    OutBuffer - Returns the output data.
    OutBufferSize - Supplies the size, in bytes, of the data pointed
        to by OutBuffer.
    BytesReturned - The number of bytes returned in OutBuffer.
Return Value:
    ERROR_SUCCESS - The function completed successfully.
    ERROR_INVALID_PARAMETER - The data is formatted incorrectly.
    ERROR_NOT_ENOUGH_MEMORY - An error occurred allocating memory.
    Win32 error code - The function failed.
--*/
{
    DWORD           status;
    DWORD           required;
    status = ResUtilGetAllProperties( ResourceEntry->ParametersKey,
                                      SmbSmpResourcePrivateProperties,
                                      OutBuffer,
                                      OutBufferSize,
                                      BytesReturned,
                                      &required );
    if ( status == ERROR_MORE_DATA ) {
        *BytesReturned = required;
    }
    return(status);
} // SmbSmpGetPrivateResProperties

DWORD
SmbSmpValidatePrivateResProperties(
    IN OUT PSMBSMP_RESOURCE ResourceEntry,
    IN PVOID InBuffer,
    IN DWORD InBufferSize,
    OUT PSMBSMP_PARAMS Params
    )
/*++
Routine Description:
    Processes the CLUSCTL_RESOURCE_VALIDATE_PRIVATE_PROPERTIES control
    function for resources of type SMB Sample.
Arguments:
    ResourceEntry - Supplies the resource entry on which to operate.
    InBuffer - Supplies a pointer to a buffer containing input data.
    InBufferSize - Supplies the size, in bytes, of the data pointed
        to by InBuffer.
    Params - Supplies the parameter block to fill in.
Return Value:
    ERROR_SUCCESS - The function completed successfully.
    ERROR_INVALID_PARAMETER - The data is formatted incorrectly.
    ERROR_NOT_ENOUGH_MEMORY - An error occurred allocating memory.
    Win32 error code - The function failed.
--*/
{
    DWORD           status = ERROR_SUCCESS;
    SMBSMP_PARAMS   params;
    PSMBSMP_PARAMS  pParams;
    //
    // Check if there is input data.
    //
    if ( (InBuffer == NULL) ||
         (InBufferSize < sizeof(DWORD)) ) {
        return(ERROR_INVALID_DATA);
    }
    //
    // Duplicate the resource parameter block.
    //
    if ( Params == NULL ) {
        pParams = &params;
    } else {
        pParams = Params;
    }
    ZeroMemory( pParams, sizeof(SMBSMP_PARAMS) );
    status = ResUtilDupParameterBlock( (LPBYTE) pParams,
                                       (LPBYTE) &ResourceEntry->Params,
                                       SmbSmpResourcePrivateProperties );
    if ( status != ERROR_SUCCESS ) {
        return(status);
    }
    //
    // Parse and validate the properties.
    //
    status = ResUtilVerifyPropertyTable( SmbSmpResourcePrivateProperties,
                                         NULL,
                                         TRUE, // AllowUnknownProperties
                                         InBuffer,
                                         InBufferSize,
                                         (LPBYTE) pParams );
    if ( status == ERROR_SUCCESS ) {
        //
        // Validate the parameter values.
        //
        // TODO: Code to validate interactions between parameters goes here.
    }
    //
    // Cleanup our parameter block.
    //
    if ( pParams == &params ) {
        ResUtilFreeParameterBlock( (LPBYTE) &params,
                                   (LPBYTE) &ResourceEntry->Params,
                                   SmbSmpResourcePrivateProperties );
    }
    return status;
} // SmbSmpValidatePrivateResProperties

DWORD
SmbSmpSetPrivateResProperties(
    IN OUT PSMBSMP_RESOURCE ResourceEntry,
    IN PVOID InBuffer,
    IN DWORD InBufferSize
    )
/*++
Routine Description:
    Processes the CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES control function
    for resources of type SMB Sample.
Arguments:
    ResourceEntry - Supplies the resource entry on which to operate.
    InBuffer - Supplies a pointer to a buffer containing input data.
    InBufferSize - Supplies the size, in bytes, of the data pointed
        to by InBuffer.
Return Value:
    ERROR_SUCCESS - The function completed successfully.
    ERROR_INVALID_PARAMETER - The data is formatted incorrectly.
    ERROR_NOT_ENOUGH_MEMORY - An error occurred allocating memory.
    Win32 error code - The function failed.
--*/
{
    DWORD           status = ERROR_SUCCESS;
    SMBSMP_PARAMS   params;
    //
    // Parse the properties so they can be validated together.
    // This routine does individual property validation.
    //
    status = SmbSmpValidatePrivateResProperties( ResourceEntry, InBuffer, InBufferSize, &params );
    if ( status != ERROR_SUCCESS ) {
        ResUtilFreeParameterBlock( (LPBYTE) &params,
                                   (LPBYTE) &ResourceEntry->Params,
                                   SmbSmpResourcePrivateProperties );
        return(status);
    }
    //
    // Save the parameter values.
    //
    status = ResUtilSetPropertyParameterBlock( ResourceEntry->ParametersKey,
                                               SmbSmpResourcePrivateProperties,
                                               NULL,
                                               (LPBYTE) &params,
                                               InBuffer,
                                               InBufferSize,
                                               (LPBYTE) &ResourceEntry->Params );
    ResUtilFreeParameterBlock( (LPBYTE) &params,
                               (LPBYTE) &ResourceEntry->Params,
                               SmbSmpResourcePrivateProperties );
    //
    // If the resource is online, return a non-success status.
    //
    // TODO: Modify the code below if your resource can handle
    // changes to properties while it is still online.
    if ( status == ERROR_SUCCESS ) {
        if ( ResourceEntry->State == ClusterResourceOnline ) {
            status = ERROR_RESOURCE_PROPERTIES_STORED;
        } else if ( ResourceEntry->State == ClusterResourceOnlinePending ) {
            status = ERROR_RESOURCE_PROPERTIES_STORED;
        } else {
            status = ERROR_SUCCESS;
        }
    }
    return status;
} // SmbSmpSetPrivateResProperties
//***********************************************************
//
// Define Function Table
//
//***********************************************************
CLRES_V1_FUNCTION_TABLE( g_SmbSmpFunctionTable,     // Name
                         CLRES_VERSION_V1_00,         // Version
                         SmbSmp,                    // Prefix
                         NULL,                        // Arbitrate
                         NULL,                        // Release
                         SmbSmpResourceControl,     // ResControl
                         SmbSmpResourceTypeControl); // ResTypeControl

						