331 lines
11 KiB
C
331 lines
11 KiB
C
|
//+----------------------------------------------------------------------------
|
||
|
|
//
|
||
|
|
// Windows NT Directory Service Property Pages
|
||
|
|
//
|
||
|
|
// Microsoft Windows
|
||
|
|
// Copyright (C) Microsoft Corporation, 1992 - 1999
|
||
|
|
//
|
||
|
|
// File: dscmn.h
|
||
|
|
//
|
||
|
|
// Contents: Methods exported from DSPROP.DLL for use in DSADMIN.DLL
|
||
|
|
//
|
||
|
|
// History: 19-February-98 JonN created
|
||
|
|
//
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
|
||
|
|
#ifndef _DSCMN_H_
|
||
|
|
#define _DSCMN_H_
|
||
|
|
|
||
|
|
#include <ADsOpenFlags.h> // GetADsOpenObjectFlags
|
||
|
|
|
||
|
|
//
|
||
|
|
// Illegal characters that cannot be used in the UPN or SAM Account name
|
||
|
|
//
|
||
|
|
#define INVALID_ACCOUNT_NAME_CHARS L"\"/\\[]:|<>+=;,?,*"
|
||
|
|
#define INVALID_ACCOUNT_NAME_CHARS_WITH_AT L"\"/\\[]:|<>+=;,?,*@"
|
||
|
|
|
||
|
|
// This GUID is copied from ds\setup\schema.ini
|
||
|
|
#define SZ_GUID_CONTROL_UserChangePassword L"ab721a53-1e2f-11d0-9819-00aa0040529b"
|
||
|
|
extern const GUID GUID_CONTROL_UserChangePassword;
|
||
|
|
/* add this to your source:
|
||
|
|
const GUID GUID_CONTROL_UserChangePassword =
|
||
|
|
{ 0xab721a53, 0x1e2f, 0x11d0, { 0x98, 0x19, 0x00, 0xaa, 0x00, 0x40, 0x52, 0x9b}};
|
||
|
|
*/
|
||
|
|
|
||
|
|
HRESULT DSPROP_PickComputer(
|
||
|
|
IN HWND hwndParent,
|
||
|
|
IN LPCWSTR lpcwszRootPath, // only the server name is used
|
||
|
|
OUT BSTR* pbstrADsPath );
|
||
|
|
HRESULT DSPROP_PickNTDSDSA(
|
||
|
|
IN HWND hwndParent,
|
||
|
|
IN LPCWSTR lpcwszRootPath,
|
||
|
|
OUT BSTR* pbstrADsPath );
|
||
|
|
HRESULT DSPROP_DSQuery(
|
||
|
|
IN HWND hwndParent,
|
||
|
|
IN LPCWSTR lpcwszRootPath,
|
||
|
|
IN CLSID* pclsidDefaultForm,
|
||
|
|
OUT BSTR* pbstrADsPath );
|
||
|
|
HRESULT DSPROP_IsFrsObject( IN LPWSTR pszClassName, OUT bool* pfIsFrsObject );
|
||
|
|
HRESULT DSPROP_RemoveX500LeafElements(
|
||
|
|
IN unsigned int nElements,
|
||
|
|
IN OUT BSTR* pbstrADsPath );
|
||
|
|
HRESULT DSPROP_TweakADsPath(
|
||
|
|
IN LPCWSTR lpcwszInitialADsPath,
|
||
|
|
IN int iTargetLevelsUp,
|
||
|
|
IN PWCHAR* ppwszTargetLevelsBack,
|
||
|
|
OUT BSTR* pbstrResultDN
|
||
|
|
);
|
||
|
|
HRESULT DSPROP_RetrieveRDN(
|
||
|
|
IN LPCWSTR lpwszDN,
|
||
|
|
OUT BSTR* pbstrRDN
|
||
|
|
);
|
||
|
|
//HRESULT DSPROP_GetGCSearch(
|
||
|
|
// IN REFIID iid,
|
||
|
|
// OUT void** ppvObject
|
||
|
|
// );
|
||
|
|
HRESULT DSPROP_GetGCSearchOnDomain(
|
||
|
|
PWSTR pwzDomainDnsName,
|
||
|
|
IN REFIID iid,
|
||
|
|
OUT void** ppvObject
|
||
|
|
);
|
||
|
|
|
||
|
|
typedef enum {
|
||
|
|
GET_OBJ_CAN_NAME,
|
||
|
|
GET_OBJ_CAN_NAME_EX,
|
||
|
|
GET_OBJ_1779_DN,
|
||
|
|
GET_OBJ_NT4_NAME,
|
||
|
|
GET_DNS_DOMAIN_NAME,
|
||
|
|
GET_NT4_DOMAIN_NAME,
|
||
|
|
GET_FQDN_DOMAIN_NAME,
|
||
|
|
GET_OBJ_UPN
|
||
|
|
} CRACK_NAME_OPR;
|
||
|
|
|
||
|
|
HRESULT CrackName(PWSTR pwzNameIn, PWSTR * ppwzDnsName,
|
||
|
|
CRACK_NAME_OPR Opr, HWND hWnd = NULL);
|
||
|
|
|
||
|
|
void MsgBox(UINT MsgID, HWND hWnd);
|
||
|
|
void MsgBox2(UINT MsgID, UINT InsertID, HWND hWnd);
|
||
|
|
//
|
||
|
|
// Error reporting. Note, use MsgBoxX (see above) for non-error messages.
|
||
|
|
//
|
||
|
|
void ErrMsg(UINT MsgID, HWND hWnd = NULL);
|
||
|
|
void ErrMsgParam(UINT MsgID, LPARAM param, HWND hWnd = NULL);
|
||
|
|
|
||
|
|
BOOL CheckADsError(HRESULT * phr, BOOL fIgnoreAttrNotFound, PSTR file,
|
||
|
|
int line, HWND hwnd = NULL);
|
||
|
|
#define CHECK_ADS_HR(phr, hwnd) CheckADsError(phr, FALSE, __FILE__, __LINE__, hwnd)
|
||
|
|
#define CHECK_ADS_HR_IGNORE_UNFOUND_ATTR(phr, hwnd) \
|
||
|
|
CheckADsError(phr, TRUE, __FILE__, __LINE__, hwnd)
|
||
|
|
void ReportError(HRESULT hr, int nStr, HWND hWnd = NULL);
|
||
|
|
#if defined(DSADMIN)
|
||
|
|
//+----------------------------------------------------------------------------
|
||
|
|
//
|
||
|
|
// Function: SuperMsgBox
|
||
|
|
//
|
||
|
|
// Synopsis: Displays a message obtained from a string resource with
|
||
|
|
// the parameters expanded. The error param, dwErr, if
|
||
|
|
// non-zero, is converted to a string and becomes the first
|
||
|
|
// replaceable param.
|
||
|
|
//
|
||
|
|
// This function includes the functionality of ReportErrorEx in
|
||
|
|
// dsadmin\util.cpp *except* it does not have SpecialMessageBox.
|
||
|
|
// It also can replace ReportMessageEx by setting dwErr to zero.
|
||
|
|
//
|
||
|
|
// Note: this function is UNICODE-only.
|
||
|
|
//
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
int SuperMsgBox(
|
||
|
|
HWND hWnd, // owning window.
|
||
|
|
int nMessageId, // string resource ID of message. Must have replacable params to match nArguments.
|
||
|
|
int nTitleId, // string resource ID of the title. If zero, uses IDS_MSG_TITLE.
|
||
|
|
UINT ufStyle, // MessageBox flags.
|
||
|
|
DWORD dwErr, // Error code, or zero if not needed.
|
||
|
|
PVOID * rgpvArgs, // array of pointers/values for substitution in the nMessageId string.
|
||
|
|
int nArguments, // count of pointers in string array.
|
||
|
|
BOOL fTryADSiErrors,// If the failure is the result of an ADSI call, see if an ADSI extended error.
|
||
|
|
PSTR szFile, // use the __FILE__ macro. ignored in retail build.
|
||
|
|
int nLine // use the __LINE__ macro. ignored in retail build.
|
||
|
|
);
|
||
|
|
#endif //defined(DSADMIN)
|
||
|
|
|
||
|
|
HRESULT
|
||
|
|
ModifyNetWareUserPassword(
|
||
|
|
IN IADsUser* pADsUser,
|
||
|
|
IN PCWSTR pwzADsPath,
|
||
|
|
IN PCWSTR pwzNewPassword
|
||
|
|
);
|
||
|
|
|
||
|
|
BOOL CheckGroupUpdate(HRESULT hr, HWND hPage = NULL, BOOL fAdd = TRUE, PWSTR pwzDN = NULL);
|
||
|
|
|
||
|
|
#ifndef dspAssert
|
||
|
|
#define dspAssert ASSERT
|
||
|
|
#endif
|
||
|
|
|
||
|
|
// smartpointer for PADS_ATTR_INFO
|
||
|
|
class Smart_PADS_ATTR_INFO
|
||
|
|
{
|
||
|
|
private:
|
||
|
|
PADS_ATTR_INFO m_pAttrs;
|
||
|
|
public:
|
||
|
|
Smart_PADS_ATTR_INFO::Smart_PADS_ATTR_INFO() : m_pAttrs(NULL) {}
|
||
|
|
Smart_PADS_ATTR_INFO::~Smart_PADS_ATTR_INFO() { Empty(); }
|
||
|
|
operator PADS_ATTR_INFO() const { return m_pAttrs; }
|
||
|
|
PADS_ATTR_INFO* operator&() { return &m_pAttrs; }
|
||
|
|
PADS_ATTR_INFO operator->() {dspAssert(m_pAttrs); return m_pAttrs;}
|
||
|
|
void Empty()
|
||
|
|
{
|
||
|
|
if (NULL != m_pAttrs)
|
||
|
|
{
|
||
|
|
FreeADsMem( m_pAttrs );
|
||
|
|
m_pAttrs = NULL;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
};
|
||
|
|
|
||
|
|
// smartpointer for DsBind handle
|
||
|
|
void Smart_DsHandle__Empty( HANDLE* phDs );
|
||
|
|
class Smart_DsHandle
|
||
|
|
{
|
||
|
|
private:
|
||
|
|
HANDLE m_hDs;
|
||
|
|
public:
|
||
|
|
Smart_DsHandle::Smart_DsHandle() : m_hDs(NULL) {}
|
||
|
|
Smart_DsHandle::~Smart_DsHandle() { Empty(); }
|
||
|
|
operator HANDLE() const { return m_hDs; }
|
||
|
|
HANDLE* operator&() { return &m_hDs; }
|
||
|
|
void Empty() { Smart_DsHandle__Empty( &m_hDs ); }
|
||
|
|
};
|
||
|
|
|
||
|
|
class DSPROP_BSTR_BLOCK;
|
||
|
|
bool DSPROP_BSTR_BLOCK__SetCount( DSPROP_BSTR_BLOCK& block, int cItems );
|
||
|
|
BSTR& DSPROP_BSTR_BLOCK__Reference( DSPROP_BSTR_BLOCK& block, int iItem );
|
||
|
|
|
||
|
|
class DSPROP_BSTR_BLOCK
|
||
|
|
{
|
||
|
|
public:
|
||
|
|
DSPROP_BSTR_BLOCK()
|
||
|
|
: m_cItems( 0 )
|
||
|
|
, m_abstrItems( NULL ) {}
|
||
|
|
~DSPROP_BSTR_BLOCK() { Empty(); }
|
||
|
|
|
||
|
|
int QueryCount() const { return m_cItems; }
|
||
|
|
const BSTR operator[](int iItem) const
|
||
|
|
{ return DSPROP_BSTR_BLOCK__Reference(
|
||
|
|
const_cast<DSPROP_BSTR_BLOCK&>(*this), iItem ); }
|
||
|
|
operator const BSTR*() const { return m_abstrItems; }
|
||
|
|
operator LPWSTR*() const { return (LPWSTR*)m_abstrItems; }
|
||
|
|
|
||
|
|
bool SetCount( int cItems )
|
||
|
|
{ return DSPROP_BSTR_BLOCK__SetCount( *this, cItems ); }
|
||
|
|
bool Set( BSTR cbstrItem, int iItem )
|
||
|
|
{
|
||
|
|
return (NULL != (
|
||
|
|
DSPROP_BSTR_BLOCK__Reference( *this, iItem ) =
|
||
|
|
::SysAllocString(cbstrItem) ) );
|
||
|
|
}
|
||
|
|
|
||
|
|
void Empty() { (void) SetCount(0); }
|
||
|
|
|
||
|
|
private:
|
||
|
|
int m_cItems;
|
||
|
|
BSTR* m_abstrItems;
|
||
|
|
|
||
|
|
friend bool DSPROP_BSTR_BLOCK__SetCount( DSPROP_BSTR_BLOCK& block, int cItems );
|
||
|
|
friend BSTR& DSPROP_BSTR_BLOCK__Reference( DSPROP_BSTR_BLOCK& block, int iItem );
|
||
|
|
};
|
||
|
|
|
||
|
|
HRESULT DSPROP_ShallowSearch(
|
||
|
|
IN OUT DSPROP_BSTR_BLOCK* pbstrBlock,
|
||
|
|
IN LPCTSTR lpcwszADsPathDirectory,
|
||
|
|
IN LPCTSTR lpcwszTargetDesiredClass,
|
||
|
|
IN PADS_ATTR_INFO pAttrInfoExclusions = NULL
|
||
|
|
);
|
||
|
|
|
||
|
|
// The following functions support duelling listbox capability
|
||
|
|
HRESULT DSPROP_Duelling_Populate(
|
||
|
|
IN HWND hwndListbox,
|
||
|
|
IN const DSPROP_BSTR_BLOCK& bstrblock
|
||
|
|
);
|
||
|
|
void DSPROP_Duelling_UpdateButtons(
|
||
|
|
HWND hwndDlg,
|
||
|
|
int nAnyCtrlid
|
||
|
|
);
|
||
|
|
void DSPROP_Duelling_ButtonClick(
|
||
|
|
HWND hwndDlg,
|
||
|
|
int nButtonCtrlid
|
||
|
|
);
|
||
|
|
void DSPROP_Duelling_ClearListbox(
|
||
|
|
HWND hwndListbox
|
||
|
|
);
|
||
|
|
|
||
|
|
// JonN 4/8/99: add code to enable horizontal scrolling where appropriate
|
||
|
|
HRESULT DSPROP_HScrollStringListbox(
|
||
|
|
HWND hwndListbox
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD DSPROP_CreateHomeDirectory(IN PSID pUserSid, IN LPCWSTR lpszPathName);
|
||
|
|
BOOL DSPROP_IsValidUNCPath(LPCWSTR lpszPath);
|
||
|
|
|
||
|
|
void DSPROP_DomainVersionDlg(PCWSTR pwzDomainPath, PCWSTR pwzDomainDnsName,
|
||
|
|
HWND hWndParent);
|
||
|
|
void DSPROP_ForestVersionDlg(PCWSTR pwzConfigPath, PCWSTR pwzPartitionsPath,
|
||
|
|
PCWSTR pwzSchemaPath, PCWSTR pwzRootDnsName,
|
||
|
|
HWND hWndParent);
|
||
|
|
|
||
|
|
|
||
|
|
//
|
||
|
|
// This is a wrapper for ADsOpenObject. It gives DSAdmin a single point to change
|
||
|
|
// global flags that are passed to ADsOpenObject without have to search and replace
|
||
|
|
// all occurrences in the code
|
||
|
|
//
|
||
|
|
inline
|
||
|
|
HRESULT DSAdminOpenObject(PCWSTR pszPath,
|
||
|
|
REFIID refIID,
|
||
|
|
PVOID* ppObject,
|
||
|
|
BOOL bServer = FALSE)
|
||
|
|
{
|
||
|
|
HRESULT hr = S_OK;
|
||
|
|
DWORD dwFlags = ADS_SECURE_AUTHENTICATION;
|
||
|
|
|
||
|
|
if (bServer)
|
||
|
|
{
|
||
|
|
//
|
||
|
|
// If we know we are connecting to a specific server and not domain in general
|
||
|
|
// then pass the ADS_SERVER_BIND flag to save ADSI the trouble of figuring it out
|
||
|
|
//
|
||
|
|
dwFlags |= ADS_SERVER_BIND;
|
||
|
|
}
|
||
|
|
|
||
|
|
//
|
||
|
|
// Get the security flags for ADsOpenObject using the published inline function
|
||
|
|
// so that we can turn off signing/sealing/etc. based on regkeys.
|
||
|
|
// For performance reasons we only want to read the regkey once.
|
||
|
|
//
|
||
|
|
static DWORD retrievedFlags = GetADsOpenObjectFlags();
|
||
|
|
|
||
|
|
dwFlags |= retrievedFlags;
|
||
|
|
|
||
|
|
hr = ADsOpenObject((LPWSTR)pszPath, NULL, NULL, dwFlags, refIID, ppObject);
|
||
|
|
|
||
|
|
return hr;
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
//+---------------------------------------------------------------------------
|
||
|
|
//
|
||
|
|
// Function: GetDsObjectSD
|
||
|
|
// Synopsis: Reads the security descriptor from the specied DS object
|
||
|
|
// It only reads the DACL portion of the security descriptor
|
||
|
|
//
|
||
|
|
// Arguments: [IN pszObjectPath] -- LDAP Path of ds object
|
||
|
|
// [ppDACL] --pointer to dacl in ppSD is returned here
|
||
|
|
// [OUT ppSD] -- Security descriptor returned here.
|
||
|
|
// calling API must free this by calling LocalFree
|
||
|
|
//
|
||
|
|
// Notes: The returned security descriptor must be freed with LocalFree
|
||
|
|
//
|
||
|
|
//----------------------------------------------------------------------------
|
||
|
|
HRESULT GetDsObjectSD(LPCWSTR pszObjectPath,
|
||
|
|
PACL* ppDACL,
|
||
|
|
PSECURITY_DESCRIPTOR* ppSecurityDescriptor);
|
||
|
|
|
||
|
|
|
||
|
|
//+---------------------------------------------------------------------------
|
||
|
|
//
|
||
|
|
// Function: SetDsObjectDacl
|
||
|
|
// Synopsis: Writes the specified DACL to the specified DS object
|
||
|
|
//
|
||
|
|
// Arguments: [IN pszObjectPath] -- LDAP Path of ds object
|
||
|
|
// [pDACL] -- pointer to dacl to be set
|
||
|
|
//
|
||
|
|
// Notes:
|
||
|
|
//
|
||
|
|
//----------------------------------------------------------------------------
|
||
|
|
HRESULT SetDsObjectDacl(LPCWSTR pszObjectPath,
|
||
|
|
PACL pDACL);
|
||
|
|
|
||
|
|
|
||
|
|
#endif // _DSCMN_H_
|