windows-nt/Source/XPSP1/NT/admin/netui/common/h/uintmem.hxx

120 lines
2.4 KiB
C++
Raw Permalink Normal View History

2020-09-26 03:20:57 -05:00
/**********************************************************************/
/** Microsoft Windows NT **/
/** Copyright(c) Microsoft Corp., 1992 **/
/**********************************************************************/
/*
*
*
*
*
* History
* jonn 01/17/92 Created
* thomaspa 02/22/92 Split int hxx/cxx
* thomaspa 03/03/92 Split off from NTSAM.HXX
* thomaspa 03/30/92 Code review changes
*/
#ifndef _UINTMEM_HXX_
#define _UINTMEM_HXX_
#include "uiassert.hxx"
/**********************************************************\
NAME: ::FillUnicodeString
SYNOPSIS: Standalone method for filling in a UNICODE_STRING struct using
an NLS_STR
\**********************************************************/
APIERR FillUnicodeString( UNICODE_STRING * punistr, const NLS_STR & pnls );
/**********************************************************\
NAME: ::FreeUnicodeString
SYNOPSIS: Standalone method for freeing the memory allocated
by FillUnicodeString.
\**********************************************************/
VOID FreeUnicodeString( UNICODE_STRING * puinistr );
/**********************************************************\
NAME: NT_MEMORY
SYNOPSIS: Specialized buffer object for storing data returned
from SAM and LSA APIs.
INTERFACE: NT_MEMORY(): constructor
~NT_MEMORY(): destructor
QueryBuffer(): query data buffer
QueryCount(): Query number of items
Set(): Replace data buffer and item count
NOTES:
PARENT: BASE
HISTORY:
jonn 01/17/92 Created
\**********************************************************/
DLL_CLASS NT_MEMORY : public BASE
{
private:
VOID * _pvBuffer;
ULONG _cItems;
protected:
NT_MEMORY();
~NT_MEMORY();
/*
* Check if requested item is in the buffer
*/
inline BOOL IsInRange( ULONG i ) const { return ( i < _cItems ); }
/*
* Get the buffer pointer
*/
inline VOID * QueryBuffer() const
{
return _pvBuffer;
}
public:
/*
* Set the buffer pointer and count
*/
inline virtual VOID Set( VOID * pvBuffer, ULONG cItems = 0L )
{
ASSERT( !(cItems == 0 && pvBuffer != NULL)
|| !(pvBuffer == NULL && cItems != 0) );
_pvBuffer = pvBuffer;
_cItems = cItems;
}
/*
* return the count of items in the buffer
*/
inline ULONG QueryCount() const { return _cItems; }
} ;
#endif // _UINTMEM_HXX_