You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
480 lines
11 KiB
480 lines
11 KiB
/*++
|
|
|
|
Copyright (c) 1993 Microsoft Corporation
|
|
|
|
Module Name:
|
|
|
|
canon.c
|
|
|
|
Abstract:
|
|
|
|
Contains canonicalization routines for NetWare names.
|
|
|
|
Author:
|
|
|
|
Rita Wong (ritaw) 19-Feb-1993
|
|
|
|
Environment:
|
|
|
|
|
|
Revision History:
|
|
|
|
|
|
--*/
|
|
|
|
|
|
#include <procs.h>
|
|
|
|
|
|
DWORD
|
|
NwLibValidateLocalName(
|
|
IN LPWSTR LocalName
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This routine checks to see if the supplied name is a valid
|
|
DOS device name.
|
|
|
|
Arguments:
|
|
|
|
LocalName - Supplies a local device name. It can be any of
|
|
the following:
|
|
|
|
X:
|
|
LPTn or LPTn:
|
|
COMn or COMn:
|
|
PRN or PRN:
|
|
AUX or AUX:
|
|
|
|
|
|
Return Value:
|
|
|
|
NO_ERROR - LocalName is valid.
|
|
|
|
WN_BAD_NETNAME - LocalName is invalid.
|
|
|
|
--*/
|
|
{
|
|
DWORD LocalNameLength;
|
|
|
|
|
|
//
|
|
// Cannot be a NULL or empty string
|
|
//
|
|
if (LocalName == NULL || *LocalName == 0) {
|
|
return WN_BAD_NETNAME;
|
|
}
|
|
|
|
LocalNameLength = wcslen(LocalName);
|
|
|
|
if (LocalNameLength == 1) {
|
|
return WN_BAD_NETNAME;
|
|
}
|
|
|
|
if (LocalName[LocalNameLength - 1] == L':') {
|
|
if (! IS_VALID_TOKEN(LocalName, LocalNameLength - 1)) {
|
|
return WN_BAD_NETNAME;
|
|
}
|
|
}
|
|
else {
|
|
if (! IS_VALID_TOKEN(LocalName, LocalNameLength)) {
|
|
return WN_BAD_NETNAME;
|
|
}
|
|
}
|
|
|
|
if (LocalNameLength == 2) {
|
|
//
|
|
// Must be in the form of X:
|
|
//
|
|
if (! iswalpha(*LocalName)) {
|
|
return WN_BAD_NETNAME;
|
|
}
|
|
|
|
if (LocalName[1] != L':') {
|
|
return WN_BAD_NETNAME;
|
|
}
|
|
|
|
return NO_ERROR;
|
|
}
|
|
|
|
if (RtlIsDosDeviceName_U(LocalName) == 0) {
|
|
return WN_BAD_NETNAME;
|
|
}
|
|
|
|
//
|
|
// Valid DOS device name but invalid redirection name
|
|
//
|
|
if (_wcsnicmp(LocalName, L"NUL", 3) == 0) {
|
|
return WN_BAD_NETNAME;
|
|
|
|
}
|
|
return NO_ERROR;
|
|
}
|
|
|
|
|
|
DWORD
|
|
NwLibCanonLocalName(
|
|
IN LPWSTR LocalName,
|
|
OUT LPWSTR *OutputBuffer,
|
|
OUT LPDWORD OutputBufferLength OPTIONAL
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This routine canonicalizes the local name by uppercasing the string
|
|
and converting the following:
|
|
|
|
x: -> X:
|
|
LPTn: -> LPTn
|
|
COMn: -> COMn
|
|
PRN or PRN: -> LPT1
|
|
AUX or AUX: -> COM1
|
|
|
|
Arguments:
|
|
|
|
LocalName - Supplies a local device name.
|
|
|
|
OutputBuffer - Receives a pointer to the canonicalized LocalName.
|
|
|
|
OutputBufferLength - Receives the length of the canonicalized name
|
|
in number of characters, if specified.
|
|
|
|
Return Value:
|
|
|
|
NO_ERROR - Successfully canonicalized the local name.
|
|
|
|
WN_BAD_NETNAME - LocalName is invalid.
|
|
|
|
ERROR_NOT_ENOUGH_MEMORY - Could not allocate output buffer.
|
|
|
|
--*/
|
|
{
|
|
DWORD status;
|
|
DWORD LocalNameLength;
|
|
|
|
|
|
status = NwLibValidateLocalName(LocalName);
|
|
|
|
if (status != NO_ERROR) {
|
|
return status;
|
|
}
|
|
|
|
LocalNameLength = wcslen(LocalName);
|
|
|
|
//
|
|
// Allocate output buffer. Should be the size of the LocalName
|
|
// plus 1 for the special case of PRN -> LPT1 or AUX -> COM1.
|
|
//
|
|
*OutputBuffer = (PVOID) LocalAlloc(
|
|
LMEM_ZEROINIT,
|
|
(LocalNameLength + 2) * sizeof(WCHAR)
|
|
);
|
|
|
|
if (*OutputBuffer == NULL) {
|
|
KdPrint(("NWLIB: NwLibCanonLocalName LocalAlloc failed %lu\n",
|
|
GetLastError()));
|
|
return ERROR_NOT_ENOUGH_MEMORY;
|
|
}
|
|
|
|
wcscpy(*OutputBuffer, LocalName);
|
|
|
|
if (LocalNameLength > 2) {
|
|
|
|
if (_wcsnicmp(*OutputBuffer, L"PRN", 3) == 0) {
|
|
|
|
//
|
|
// Convert PRN or PRN: to LPT1
|
|
//
|
|
wcscpy(*OutputBuffer, L"LPT1");
|
|
LocalNameLength = 4;
|
|
|
|
}
|
|
else if (_wcsnicmp(*OutputBuffer, L"AUX", 3) == 0) {
|
|
|
|
//
|
|
// Convert AUX or AUX: to COM1
|
|
//
|
|
wcscpy(*OutputBuffer, L"COM1");
|
|
LocalNameLength = 4;
|
|
}
|
|
|
|
//
|
|
// Remove trailing colon, if there is one, and decrement the length
|
|
// of DOS device name.
|
|
//
|
|
if ((*OutputBuffer)[LocalNameLength - 1] == L':') {
|
|
(*OutputBuffer)[--LocalNameLength] = 0;
|
|
}
|
|
}
|
|
|
|
//
|
|
// LocalName is always in uppercase.
|
|
//
|
|
_wcsupr(*OutputBuffer);
|
|
|
|
if (ARGUMENT_PRESENT(OutputBufferLength)) {
|
|
*OutputBufferLength = LocalNameLength;
|
|
}
|
|
|
|
return NO_ERROR;
|
|
}
|
|
|
|
|
|
DWORD
|
|
NwLibCanonRemoteName(
|
|
IN LPWSTR LocalName OPTIONAL,
|
|
IN LPWSTR RemoteName,
|
|
OUT LPWSTR *OutputBuffer,
|
|
OUT LPDWORD OutputBufferLength OPTIONAL
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This routine validates and canonicalizes the supplied
|
|
NetWare UNC name. It can be of any length in the form of:
|
|
|
|
\\Server\Volume\Directory\Subdirectory
|
|
|
|
Arguments:
|
|
|
|
LocalName - Supplies the local device name. If it is NULL, then
|
|
\\Server is an acceptable format for the UNC name.
|
|
|
|
RemoteName - Supplies the UNC name.
|
|
|
|
OutputBuffer - Receives a pointer to the canonicalized RemoteName.
|
|
|
|
OutputBufferLength - Receives the length of the canonicalized name
|
|
in number of characters, if specified.
|
|
|
|
Return Value:
|
|
|
|
NO_ERROR - RemoteName is valid.
|
|
|
|
WN_BAD_NETNAME - RemoteName is invalid.
|
|
|
|
--*/
|
|
{
|
|
DWORD RemoteNameLength;
|
|
DWORD i;
|
|
DWORD TokenLength;
|
|
LPWSTR TokenPtr;
|
|
BOOL fFirstToken = TRUE;
|
|
|
|
|
|
//
|
|
// Cannot be a NULL or empty string
|
|
//
|
|
if (RemoteName == NULL || *RemoteName == 0) {
|
|
return WN_BAD_NETNAME;
|
|
}
|
|
|
|
RemoteNameLength = wcslen(RemoteName);
|
|
|
|
//
|
|
// Must be at least \\x\y if local device name is specified.
|
|
// Otherwise it must be at least \\x.
|
|
//
|
|
if ((RemoteNameLength < 5 && ARGUMENT_PRESENT(LocalName)) ||
|
|
(RemoteNameLength < 3)) {
|
|
return WN_BAD_NETNAME;
|
|
}
|
|
|
|
//
|
|
// First two characters must be "\\"
|
|
//
|
|
if (*RemoteName != L'\\' || RemoteName[1] != L'\\') {
|
|
return WN_BAD_NETNAME;
|
|
}
|
|
|
|
if (! ARGUMENT_PRESENT(LocalName) &&
|
|
(IS_VALID_TOKEN(&RemoteName[2], RemoteNameLength - 2))) {
|
|
|
|
//
|
|
// Return success for \\Server case.
|
|
//
|
|
|
|
*OutputBuffer = (PVOID) LocalAlloc(
|
|
LMEM_ZEROINIT,
|
|
(RemoteNameLength + 1) * sizeof(WCHAR)
|
|
);
|
|
|
|
if (*OutputBuffer == NULL) {
|
|
KdPrint(("NWLIB: NwLibCanonRemoteName LocalAlloc failed %lu\n",
|
|
GetLastError()));
|
|
return ERROR_NOT_ENOUGH_MEMORY;
|
|
}
|
|
|
|
wcscpy(*OutputBuffer, RemoteName);
|
|
|
|
return NO_ERROR;
|
|
}
|
|
|
|
//
|
|
// Must have at least one more backslash after the third character
|
|
//
|
|
if (wcschr(&RemoteName[3], L'\\') == NULL) {
|
|
return WN_BAD_NETNAME;
|
|
}
|
|
|
|
//
|
|
// Last character cannot a backward slash
|
|
//
|
|
if (RemoteName[RemoteNameLength - 1] == L'\\') {
|
|
return WN_BAD_NETNAME;
|
|
}
|
|
|
|
//
|
|
// Allocate output buffer. Should be the size of the RemoteName
|
|
// and space for an extra character to simplify parsing code below.
|
|
//
|
|
*OutputBuffer = (PVOID) LocalAlloc(
|
|
LMEM_ZEROINIT,
|
|
(RemoteNameLength + 2) * sizeof(WCHAR)
|
|
);
|
|
|
|
|
|
if (*OutputBuffer == NULL) {
|
|
KdPrint(("NWLIB: NwLibCanonRemoteName LocalAlloc failed %lu\n",
|
|
GetLastError()));
|
|
return ERROR_NOT_ENOUGH_MEMORY;
|
|
}
|
|
|
|
wcscpy(*OutputBuffer, RemoteName);
|
|
|
|
//
|
|
// Convert all backslashes to NULL terminator, skipping first 2 chars.
|
|
//
|
|
for (i = 2; i < RemoteNameLength; i++) {
|
|
if ((*OutputBuffer)[i] == L'\\') {
|
|
|
|
(*OutputBuffer)[i] = 0;
|
|
|
|
//
|
|
// Two consecutive forward or backslashes is bad.
|
|
//
|
|
if ((i + 1 < RemoteNameLength) &&
|
|
((*OutputBuffer)[i + 1] == L'\\')) {
|
|
|
|
(void) LocalFree((HLOCAL) *OutputBuffer);
|
|
*OutputBuffer = NULL;
|
|
return WN_BAD_NETNAME;
|
|
}
|
|
}
|
|
}
|
|
|
|
//
|
|
// Validate each token of the RemoteName, separated by NULL terminator.
|
|
//
|
|
TokenPtr = *OutputBuffer + 2; // Skip first 2 chars
|
|
|
|
while (*TokenPtr != 0) {
|
|
|
|
TokenLength = wcslen(TokenPtr);
|
|
|
|
if ( ( fFirstToken && !IS_VALID_SERVER_TOKEN(TokenPtr, TokenLength))
|
|
|| ( !fFirstToken && !IS_VALID_TOKEN(TokenPtr, TokenLength))
|
|
)
|
|
{
|
|
(void) LocalFree((HLOCAL) *OutputBuffer);
|
|
*OutputBuffer = NULL;
|
|
return WN_BAD_NETNAME;
|
|
}
|
|
|
|
fFirstToken = FALSE;
|
|
TokenPtr += TokenLength + 1;
|
|
}
|
|
|
|
//
|
|
// Convert NULL separators to backslashes
|
|
//
|
|
for (i = 0; i < RemoteNameLength; i++) {
|
|
if ((*OutputBuffer)[i] == 0) {
|
|
(*OutputBuffer)[i] = L'\\';
|
|
}
|
|
}
|
|
|
|
if (ARGUMENT_PRESENT(OutputBufferLength)) {
|
|
*OutputBufferLength = RemoteNameLength;
|
|
}
|
|
|
|
return NO_ERROR;
|
|
}
|
|
|
|
|
|
DWORD
|
|
NwLibCanonUserName(
|
|
IN LPWSTR UserName,
|
|
OUT LPWSTR *OutputBuffer,
|
|
OUT LPDWORD OutputBufferLength OPTIONAL
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This routine canonicalizes the user name by checking to see
|
|
if the name contains any illegal characters.
|
|
|
|
|
|
Arguments:
|
|
|
|
UserName - Supplies a username.
|
|
|
|
OutputBuffer - Receives a pointer to the canonicalized UserName.
|
|
|
|
OutputBufferLength - Receives the length of the canonicalized name
|
|
in number of characters, if specified.
|
|
|
|
Return Value:
|
|
|
|
NO_ERROR - Successfully canonicalized the username.
|
|
|
|
WN_BAD_NETNAME - UserName is invalid.
|
|
|
|
ERROR_NOT_ENOUGH_MEMORY - Could not allocate output buffer.
|
|
|
|
--*/
|
|
{
|
|
DWORD UserNameLength;
|
|
|
|
|
|
//
|
|
// Cannot be a NULL or empty string
|
|
//
|
|
if (UserName == NULL) {
|
|
return WN_BAD_NETNAME;
|
|
}
|
|
|
|
UserNameLength = wcslen(UserName);
|
|
|
|
if (! IS_VALID_TOKEN(UserName, UserNameLength)) {
|
|
return WN_BAD_NETNAME;
|
|
}
|
|
|
|
//
|
|
// Allocate output buffer. Should be the size of the UserName
|
|
// plus 1 for the special case of PRN -> LPT1 or AUX -> COM1.
|
|
//
|
|
*OutputBuffer = (PVOID) LocalAlloc(
|
|
LMEM_ZEROINIT,
|
|
(UserNameLength + 1) * sizeof(WCHAR)
|
|
);
|
|
|
|
if (*OutputBuffer == NULL) {
|
|
KdPrint(("NWLIB: NwLibCanonUserName LocalAlloc failed %lu\n",
|
|
GetLastError()));
|
|
return ERROR_NOT_ENOUGH_MEMORY;
|
|
}
|
|
|
|
wcscpy(*OutputBuffer, UserName);
|
|
|
|
if (ARGUMENT_PRESENT(OutputBufferLength)) {
|
|
*OutputBufferLength = UserNameLength;
|
|
}
|
|
|
|
return NO_ERROR;
|
|
}
|