Parsing Property Lists

  • Article

The recommended way to parse a property list is to use one of the property list parsing functions to locate a specific type of value. Both cluster-aware applications and resource DLLs can use these functions.

If no parsing function exists for the type of data you are seeking, you can parse the property list with CLUSPROP_BUFFER_HELPER (see Using CLUSPROP_BUFFER_HELPER).

#include <windows.h>

//////////////////////////////////////////////////////////////////////

#include "ClusDocEx.h"

//////////////////////////////////////////////////////////////////////

#ifndef _CLUSDOCEX_GRPGETRWCDWPROPVALUE_CPP
#define _CLUSDOCEX_GRPGETRWCDWPROPVALUE_CPP
//--------------------------------------------------------------------
//
//  ClusDocEx_GrpGetRWCDwPropValue
//
//  Retrieves a read-write common (RWC) group property value
//  of type DWORD.
//
//  Arguments:
//      IN HGROUP hGroup            Handle to the group.
//      IN LPWSTR lpszPropName      Name of property to find.
//      OUT LPDWORD lpdwPropValue   Returns the value of property.
//
// Return Value:
//      System error code
//
//--------------------------------------------------------------------
DWORD GrpGetRWCDwPropValue( 
    IN HGROUP hGroup,
    IN LPCWSTR lpszPropName,
    OUT LPDWORD lpdwPropValue
)
{
    DWORD dwResult = ERROR_SUCCESS;
    DWORD cbPropListSize = 0;

//  Retrieve a property list

    LPVOID lpPropList = ClusDocEx_GrpGetControlCodeOutput(
                            hGroup,
                            NULL,
                            CLUSCTL_GROUP_GET_COMMON_PROPERTIES,
                            &amp;cbPropListSize );

    if( lpPropList != NULL )
    {

    //  Parse the property list for the property specified
    //  by lpszPropName.

        dwResult = ResUtilFindDwordProperty( 
                       lpPropList, 
                       cbPropListSize, 
                       lpszPropName, 
                       lpdwPropValue );

        if ( dwResult != ERROR_SUCCESS )
        {
        //  Add error handling if necessary.
        }

        LocalFree( lpPropList );

    }
    else
    {
        dwResult = GetLastError();
    }

    return dwResult;

}
//
//  end GrpGetRWCDwProp()
//--------------------------------------------------------------------
#endif