netsh_undoc.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
VOID WINAPI	FreeQuotedString (_In_ LPWSTR pszQuotedString)
VOID WINAPI	FreeString (_In_ LPWSTR pszString)
LPWSTR WINAPI	MakeQuotedString (_In_ LPWSTR pszString)
LPWSTR CDECL	MakeString (_In_ HANDLE hModule, _In_ DWORD dwMsgId,...)
DWORD WINAPI	MatchTagsInCmdLine (_In_ HANDLE hModule, _Inout_ LPWSTR *ppwcArguments, _In_ DWORD dwCurrentIndex, _In_ DWORD dwArgCount, _Inout_ TAG_TYPE *pttTags, _In_ DWORD dwTagCount, _Out_ DWORD *pdwTagType)
DWORD WINAPI	NsGetFriendlyNameFromIfName (_In_ DWORD dwParam1, _In_ PWSTR pszIfName, _Inout_ PWSTR pszFriendlyName, _Inout_ PDWORD pdwFriendlyName)
DWORD WINAPI	NsGetIfNameFromFriendlyName (_In_ DWORD dwUnknown1, _In_ PWSTR pszFriendlyName, _Inout_ PWSTR pszIfName, _Inout_ PDWORD pdwIfName)

Function Documentation

FreeQuotedString()

VOID WINAPI FreeQuotedString

(

_In_ LPWSTR

pszQuotedString

)

Definition at line 272 of file netsh.c.

{
    DPRINT("FreeQuotedString(%S)\n", pszQuotedString);
    HeapFree(GetProcessHeap(), 0, pszQuotedString);
}

FreeString()

VOID WINAPI FreeString

(

_In_ LPWSTR

pszString

)

Definition at line 281 of file netsh.c.

{
    DPRINT("FreeString(%S)\n", pszString);
    LocalFree(pszString);
}

Referenced by CreateProcessInternalW(), IKsFilterFactory_fnInitialize(), and LoadLibraryExW().

MakeQuotedString()

LPWSTR WINAPI MakeQuotedString

(

_In_ LPWSTR

pszString

)

Definition at line 290 of file netsh.c.

{
    LPWSTR pszQuotedString;
 
    DPRINT("MakeQuotedString(%S)\n", pszString);
 
    pszQuotedString = HeapAlloc(GetProcessHeap(), 0, (wcslen(pszString) + 3) * sizeof(WCHAR));
    if (pszQuotedString == NULL)
        return NULL;
 
    _swprintf(pszQuotedString, L"\"%s\"", pszString);
 
    return pszQuotedString;
}

MakeString()

LPWSTR CDECL MakeString	(	_In_ HANDLE	hModule,
		_In_ DWORD	dwMsgId,
			...
	)

Definition at line 308 of file netsh.c.

{
    LPCWSTR pszStr;
    LPWSTR pszInBuffer, pszOutBuffer = NULL;
    DWORD dwLength;
    va_list ap;
 
    DPRINT("MakeString(%p %lu ...)\n", hModule, dwMsgId);
 
    dwLength = LoadStringW(hModule, dwMsgId, (LPWSTR)&pszStr, 0);
    if (dwLength == 0)
        return NULL;
 
    /* Allocate and copy the resource string, NUL-terminated */
    pszInBuffer = HeapAlloc(GetProcessHeap(), 0, (dwLength + 1) * sizeof(WCHAR));
    if (pszInBuffer == NULL)
        return NULL;
    CopyMemory(pszInBuffer, pszStr, dwLength * sizeof(WCHAR));
    pszInBuffer[dwLength] = UNICODE_NULL;
 
    va_start(ap, dwMsgId);
    FormatMessageW(FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_STRING,
                   pszInBuffer,
                   0,
                   0,
                   (LPWSTR)&pszOutBuffer,
                   0,
                   &ap);
    va_end(ap);
 
    HeapFree(GetProcessHeap(), 0, pszInBuffer);
 
    return pszOutBuffer;
}

MatchTagsInCmdLine()

DWORD WINAPI MatchTagsInCmdLine	(	_In_ HANDLE	hModule,
		_Inout_ LPWSTR *	ppwcArguments,
		_In_ DWORD	dwCurrentIndex,
		_In_ DWORD	dwArgCount,
		_Inout_ TAG_TYPE *	pttTags,
		_In_ DWORD	dwTagCount,
		_Out_ DWORD *	pdwTagType
	)

Definition at line 377 of file netsh.c.

{
    PWSTR pszEqual;
    DWORD i, j, dwTagLength;
 
    DPRINT1("MatchTagsInCmdLine(%p %p %lu %lu %p %lu %p)\n",
            hModule, ppwcArguments, dwCurrentIndex, dwArgCount,
            pttTags, dwTagCount, pdwTagType);
 
    /* Identify tagged arguments (tag=value) */
    for (i = dwCurrentIndex; i < dwArgCount; i++)
    {
        DPRINT("Argument %lu: %S\n", i, ppwcArguments[i]);
        pdwTagType[i - dwCurrentIndex] = (DWORD)-1;
 
        /* Skip arguments that do not have a tag */
        pszEqual = wcschr(ppwcArguments[i], L'=');
        if (pszEqual == NULL)
            continue;
 
        dwTagLength = pszEqual - ppwcArguments[i];
        DPRINT("Tag length %lu\n", dwTagLength);
        DPRINT("Value length %lu\n", wcslen(pszEqual + 1));
 
        pdwTagType[i - dwCurrentIndex] = (DWORD)-1;
        for (j = 0; j < dwTagCount; j++)
        {
            DPRINT("Test tag %S -- %S\n", pttTags[j].pwszTag, ppwcArguments[i]);
            if ((wcslen(pttTags[j].pwszTag) == dwTagLength) &&
                (_wcsnicmp(ppwcArguments[i], pttTags[j].pwszTag, dwTagLength) == 0))
            {
                DPRINT("Found tag %S\n", pttTags[j].pwszTag);
                pttTags[j].bPresent = TRUE;
                pdwTagType[i - dwCurrentIndex] = j;
 
                /* Remove the tag name from the argument */
                wcscpy(ppwcArguments[i], pszEqual + 1);
                break;
            }
        }
    }
 
    /* Identify un-tagged arguments (value) */
    for (i = dwCurrentIndex; i < dwArgCount; i++)
    {
        if (pdwTagType[i - dwCurrentIndex] != (DWORD)-1)
            continue;
 
        for (j = 0; j < dwTagCount; j++)
        {
            DPRINT("Test tag %S\n", pttTags[j].pwszTag);
            if (pttTags[j].bPresent == FALSE)
            {
                DPRINT("Found tag %S\n", pttTags[j].pwszTag);
                pttTags[j].bPresent = TRUE;
                pdwTagType[i - dwCurrentIndex] = j;
                break;
            }
        }
    }
 
    return ERROR_SUCCESS;
}

Referenced by IpAddAddress(), IpAddDns(), IpDeleteAddress(), IpDeleteArpCache(), IpDeleteDns(), IpSetAddress(), IpSetDns(), and PreprocessCommand().

NsGetFriendlyNameFromIfName()

DWORD WINAPI NsGetFriendlyNameFromIfName	(	_In_ DWORD	dwParam1,
		_In_ PWSTR	pszIfName,
		_Inout_ PWSTR	pszFriendlyName,
		_Inout_ PDWORD	pdwFriendlyName
	)

Definition at line 464 of file netsh.c.

{
    UNICODE_STRING UnicodeIfName;
    GUID InterfaceGuid;
    NTSTATUS Status;
    DWORD ret;
 
    DPRINT("NsGetFriendlyNameFromIfName(%lx %S %p %p)\n",
           dwUnknown1, pszIfName, pszFriendlyName, pdwFriendlyName);
 
    RtlInitUnicodeString(&UnicodeIfName, pszIfName);
    Status = RtlGUIDFromString(&UnicodeIfName,
                               &InterfaceGuid);
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("RtlGUIDFromString failed 0x%08lx\n", Status);
        return RtlNtStatusToDosError(Status);
    }
 
    ret = NhGetInterfaceNameFromDeviceGuid(&InterfaceGuid,
                                           pszFriendlyName,
                                           pdwFriendlyName,
                                           0, 0);
    if (ret != ERROR_SUCCESS)
    {
        DPRINT1("NhGetInterfaceNameFromDeviceGuid() failed %lu\n", ret);
    }
 
    return ret;
}

NsGetIfNameFromFriendlyName()

DWORD WINAPI NsGetIfNameFromFriendlyName	(	_In_ DWORD	dwUnknown1,
		_In_ PWSTR	pszFriendlyName,
		_Inout_ PWSTR	pszIfName,
		_Inout_ PDWORD	pdwIfName
	)

Definition at line 501 of file netsh.c.

{
    UNICODE_STRING UnicodeIfName;
    GUID InterfaceGuid;
    NTSTATUS Status;
    DWORD ret;
 
    DPRINT("NsGetIfNameFromFriendlyName(%lx %S %p %p)\n",
           dwUnknown1, pszFriendlyName, pszIfName, pdwIfName);
 
    ret = NhGetGuidFromInterfaceName(pszFriendlyName,
                                     &InterfaceGuid,
                                     0, 0);
    if (ret != ERROR_SUCCESS)
    {
        DPRINT1("NhGetGuidFromInterfaceName failed %lu\n", ret);
        return ret;
    }
 
    RtlInitUnicodeString(&UnicodeIfName, NULL);
    Status = RtlStringFromGUID(&InterfaceGuid,
                               &UnicodeIfName);
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("RtlStringFromGUID failed 0x%08lx\n", Status);
        ret = RtlNtStatusToDosError(Status);
    }
 
    if (*pdwIfName >= UnicodeIfName.MaximumLength)
    {
        CopyMemory(pszIfName, UnicodeIfName.Buffer, UnicodeIfName.MaximumLength);
        *pdwIfName = UnicodeIfName.MaximumLength;
    }
 
    RtlFreeUnicodeString(&UnicodeIfName);
 
    return ret;
}