/*****************************************************************/
/** Microsoft LAN Manager **/
/** Copyright(c) Microsoft Corp., 1990 **/
/*****************************************************************/
/*
MiscAPIs.cxx
Miscallaneous APIs
FILE HISTORY:
jonn 14-Jan-1991 Split from winprof.cxx
jonn 17-Jan-1991 Split off lm21util.cxx, lm30spfc.cxx
jonn 02-Feb-1991 Removed unused routines
rustanl 12-Apr-1991 Added UI_UNCPathCompare and
UI_UNCPathValidate
beng 17-May-1991 Correct lmui.hxx usage
jonn 22-May-1991 Added MyNetUseAdd (was in winprof.cxx)
rustanl 24-May-1991 Added AUTO_CURSOR to MyNetUseAdd
terryk 31-Oct-1991 add mnet.h and change I_NetXXX to
I_MNetXXX
Yi-HsinS 31-Dec-1991 Unicode work
terryk 10-Oct-1993 deleted MyNetUseAdd
*/
#define INCL_WINDOWS
#define INCL_WINDOWS_GDI
#define INCL_DOSERRORS
#define INCL_NETERRORS
#define INCL_NETCONS
#define INCL_NETACCESS
#define INCL_NETSERVER
#define INCL_NETWKSTA
#define INCL_NETSERVICE
#define INCL_NETLIB
#define INCL_ICANON
#define INCL_NETUSE // for NetUseAdd
#define _WINNETWK_
#include <lmui.hxx>
#undef _WINNETWK_
extern "C"
{
#include <mnet.h>
#include <winnetwk.h>
#include <npapi.h>
#include <lmsname.h>
}
#include <uiassert.hxx>
#include <uitrace.hxx>
#include <string.hxx>
#include <lmowks.hxx>
#include <lmodom.hxx>
#include <lmodev.hxx> // for DEVICE object
#include <uibuffer.hxx>
#include <strchlit.hxx> // for string and character literals
#include <lmsvc.hxx>
#include <miscapis.hxx>
/* Local prototypes */
/* functions */
/*******************************************************************
NAME: CheckLMService
SYNOPSIS: Checks to make sure the LM Wksta service is willing to
accept requests.
RETURNS: NERR_Success if the service is happy happy
WN_NO_NETWORK if the service is stopped or stopping
WN_FUNCTION_BUSY if the service is starting
Other error if an error occurred getting the status
NOTES:
HISTORY:
Johnl 09-Sep-1992 Created
********************************************************************/
APIERR CheckLMService( void )
{
APIERR err = NERR_Success ;
//
// we almost always hit the wksta soon after this call & the wksta
// is usually started. so this check will avoid paging in the service
// controller. it just ends up paging in the wksta a bit earlier.
// only if the call fails do we hit the service controller for the
// actual status.
//
WKSTA_10 wksta_10 ;
if ( (wksta_10.QueryError() == NERR_Success) &&
(wksta_10.GetInfo() == NERR_Success) )
{
return NERR_Success ;
}
LM_SERVICE service( NULL, (const TCHAR *)SERVICE_WORKSTATION );
if ( err = service.QueryError() )
{
return err ;
}
switch ( service.QueryStatus( &err ) )
{
case LM_SVC_STOPPED:
case LM_SVC_STOPPING:
if ( !err )
err = WN_NO_NETWORK ;
TRACEEOL("::CheckLMService - Returning WN_NO_NETWORK") ;
break ;
case LM_SVC_STARTING:
if ( !err )
err = WN_FUNCTION_BUSY ;
TRACEEOL("::CheckLMService - Returning WN_FUNCTION_BUSY") ;
break ;
case LM_SVC_STATUS_UNKNOWN:
case LM_SVC_STARTED:
case LM_SVC_PAUSED:
case LM_SVC_PAUSING:
case LM_SVC_CONTINUING:
default:
/* Return unadultered error code
*/
break ;
}
return err ;
}
/*******************************************************************
NAME: ParseRemoteName
SYNOPSIS: Canonicalizes a remote resource name and determines
its type
ARGUMENTS:
RemoteName - Remote resource name to be parsed
CanonName - Buffer for canonicalized name, assumed to be
MAX_PATH characters long
CanonNameSize - Size, in bytes, of output buffer
PathStart - Set to the offset, in characters, of the start
of the "\share" portion (in the REMOTENAMETYPE_SHARE case)
or the "\path" portion (in the REMOTENAMETYPE_PATH case)
of the name within CanonName. Not set in other cases.
RETURNS:
If nlsRemote is like Then returns
-------------------- ------------
workgroup REMOTENAMETYPE_WORKGROUP
\\server REMOTENAMETYPE_SERVER
\\server\share REMOTENAMETYPE_SHARE
\\server\share\path REMOTENAMETYPE_PATH
(other) REMOTENAMETYPE_INVALID
NOTES:
HISTORY:
AnirudhS 21-Apr-1995 Ported from Win95 sources - used netlib
functions rather than ad hoc parsing, introduced comments
********************************************************************/
REMOTENAMETYPE ParseRemoteName(
IN LPWSTR RemoteName,
OUT LPWSTR CanonName,
IN DWORD CanonNameSize,
OUT PULONG PathStart
)
{
//
// Determine the path type
//
DWORD PathType = 0;
NET_API_STATUS Status = I_NetPathType(NULL, RemoteName, &PathType, 0);
if (Status != NERR_Success)
{
return REMOTENAMETYPE_INVALID;
}
//
// I_NetPathType doesn't give us quite as fine a classification of
// path types as we need, so we still need to do a little more parsing
//
switch (PathType)
{
case ITYPE_PATH_RELND:
//
// A driveless relative path
// A valid workgroup or domain name would be classified as
// such, but it still needs to be validated as a workgroup name
//
Status = I_NetNameCanonicalize(
NULL, // ServerName
RemoteName, // Name
CanonName, // Outbuf
CanonNameSize, // OutbufLen
NAMETYPE_WORKGROUP, // NameType
0 // Flags
);
if (Status == NERR_Success)
{
return REMOTENAMETYPE_WORKGROUP;
}
else
{
return REMOTENAMETYPE_INVALID;
}
case ITYPE_UNC_COMPNAME:
//
// A UNC computername, "\\server"
//
{
//
// HACK: I_NetPathCanonicalize likes "\\server\share" but not
// "\\server", so append a dummy share name to canonicalize.
// We assume that the CanonName buffer will still be big
// enough (which it will, in the calls made from this file).
//
if (wcslen(RemoteName) + 3 > NNLEN)
{
return REMOTENAMETYPE_INVALID;
}
WCHAR wszDummy[NNLEN];
wcscpy(wszDummy, RemoteName);
wcscat(wszDummy, L"\\a");
UIASSERT(CanonNameSize >= sizeof(wszDummy));
PathType = ITYPE_UNC;
Status = I_NetPathCanonicalize(
NULL, // ServerName
wszDummy, // PathName
CanonName, // Outbuf
CanonNameSize, // OutbufLen
NULL, // Prefix
&PathType, // PathType
0 // Flags
);
}
if (Status != NERR_Success)
{
return REMOTENAMETYPE_INVALID;
}
CanonName[ wcslen(CanonName) - 2 ] = 0;
return REMOTENAMETYPE_SERVER;
case ITYPE_UNC:
//
// A UNC path, either "\\server\share" or "\\server\share\path" -
// canonicalize and determine which one
//
Status = I_NetPathCanonicalize(
NULL, // ServerName
RemoteName, // PathName
CanonName, // Outbuf
CanonNameSize, // OutbufLen
NULL, // Prefix
&PathType, // PathType
0 // Flags
);
if (Status != NERR_Success)
{
return REMOTENAMETYPE_INVALID;
}
{
WCHAR * pSlash = wcschr(CanonName+2, PATH_SEPARATOR);
UIASSERT(pSlash);
*PathStart = (ULONG)(pSlash - CanonName);
// Look for a fourth slash
pSlash = wcschr(pSlash+1, PATH_SEPARATOR);
if (pSlash)
{
*PathStart = (ULONG)(pSlash - CanonName);
return REMOTENAMETYPE_PATH;
}
else
{
return REMOTENAMETYPE_SHARE;
}
}
default:
return REMOTENAMETYPE_INVALID;
}
}