/**********************************************************************/
/** Microsoft Windows NT **/
/** Copyright(c) Microsoft Corp., 1992 **/
/**********************************************************************/
/*
uiexport.h
Prototypes for Net UI exported APIs
FILE HISTORY:
Johnl 17-Apr-1992 Created
*/
#ifndef _UIEXPORT_H_
#define _UIEXPORT_H_
#ifdef __cplusplus
extern "C" {
#endif
/* Selections the user can make in the System focus dialog
*/
/* Low word of the selection type
*/
#define FOCUSDLG_DOMAINS_ONLY (1)
#define FOCUSDLG_SERVERS_ONLY (2)
#define FOCUSDLG_SERVERS_AND_DOMAINS (3)
/* High word of the selection type contains a bitmask indicating
* which domains to display in the dialog.
* WARNING: This bitmask are shifted up 16 bits from the bitmask in
* \nt\private\net\ui\common\h\domenum.h. If you want to
* modify the values of the bitmask, you will need to
* make corresponding changes to domenum.h.
*
*/
#define FOCUSDLG_BROWSE_LOGON_DOMAIN 0x00010000
#define FOCUSDLG_BROWSE_WKSTA_DOMAIN 0x00020000
#define FOCUSDLG_BROWSE_OTHER_DOMAINS 0x00040000
#define FOCUSDLG_BROWSE_TRUSTING_DOMAINS 0x00080000
#define FOCUSDLG_BROWSE_WORKGROUP_DOMAINS 0x00100000
/* Some handy combinations of flags.
*/
/* FOCUSDLG_BROWSE_LM2X_DOMAINS will return only the domains available
from a LanMan 2.x workstation. This returns just the logon,
workstation, and other domains. This is the default value.
*/
#define FOCUSDLG_BROWSE_LM2X_DOMAINS ( FOCUSDLG_BROWSE_LOGON_DOMAIN | \
FOCUSDLG_BROWSE_WKSTA_DOMAIN | \
FOCUSDLG_BROWSE_OTHER_DOMAINS )
/*
FOCUSDLG_BROWSE_LOCAL_DOMAINS will return only the domains available
to the local machine. This returns the logon, workstation,
and other, plus the domains that trust "us".
*/
#define FOCUSDLG_BROWSE_LOCAL_DOMAINS ( FOCUSDLG_BROWSE_LM2X_DOMAINS | \
FOCUSDLG_BROWSE_TRUSTING_DOMAINS )
/*
FOCUSDLG_BROWSE_ALL_DOMAINS is a conglomeration of all potential domain
sources available to the domain enumerator.
*/
#define FOCUSDLG_BROWSE_ALL_DOMAINS ( FOCUSDLG_BROWSE_LOCAL_DOMAINS | \
FOCUSDLG_BROWSE_WORKGROUP_DOMAINS )
/*******************************************************************
NAME: I_SystemFocusDialog
SYNOPSIS: Presents a dialog to the user from which a server or domain
maybe selected.
ENTRY: hwndOwner - Parent window handle
nSelectionType - The type of selection the user is allowed
to make
pszName - The server or domain name. It will be
undefined if the user hits the CANCEL
button ( pfOK = FALSE )
cchBufSize - The buffer size of the lptstrName.
pfUserQuit - If the user hits the OKAY button, it will
return TRUE. Otherwise, it will return FALSE.
pszHelpFile - The helpfile to use when the user hits F1.
If NULL, the default helpfile is used.
nHelpContext - The helpcontext to use for the helpfile above.
If the above is NULL, this must be 0 (& vice
versa).
EXIT: if *pfOKPressed is TRUE (and an error didn't occur), then
lptstrName will be filled with the user selected name.
RETURNS: NO_ERROR on success, standard ERROR_* error code otherwise
NOTES: This will be a UNICODE only API when the net group goes UNICODE
HISTORY:
JohnL 22-Apr-1992 Added selection option, exported to private\inc
ChuckC 03-Nov-1992 Added helpfile & help context
********************************************************************/
UINT FAR PASCAL I_SystemFocusDialog(
HWND hwndOwner,
UINT nSelectionType,
LPWSTR pszName,
UINT cchBufSize,
BOOL *pfOKPressed,
LPWSTR pszHelpFile,
DWORD nHelpContext
);
typedef UINT (FAR PASCAL *LPFNI_SYSTEMFOCUSDIALOG)(
HWND hwndOwner,
UINT nSelectionType,
LPWSTR pszName,
UINT cchBufSize,
BOOL *pfOKPressed,
LPWSTR pszHelpFile,
DWORD nHelpContext
);
#ifdef __cplusplus
}
#endif
#endif //_UIEXPORT_H_
