iphlpapi_undoc.h File Reference

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

Go to the source code of this file.

Functions
DWORD WINAPI	NhGetGuidFromInterfaceName (_In_ PWCHAR pInterfaceName, _Out_ GUID *pInterfaceGUID, DWORD dwUnknown3, DWORD dwUnknown4)
DWORD WINAPI	NhGetInterfaceNameFromDeviceGuid (_In_ const GUID *pInterfaceGUID, _Out_writes_bytes_to_(*pOutBufLen, *pOutBufLen) PWCHAR pInterfaceName, _Inout_ PULONG pOutBufLen, DWORD dwUnknown4, DWORD dwUnknown5)
DWORD WINAPI	NhGetInterfaceNameFromGuid (_In_ const GUID *pInterfaceGUID, _Out_writes_bytes_to_(*pOutBufLen, *pOutBufLen) PWCHAR pInterfaceName, _Inout_ PULONG pOutBufLen, DWORD dwUnknown4, DWORD dwUnknown5)
DWORD WINAPI	NhpAllocateAndGetInterfaceInfoFromStack (_Inout_ IP_INTERFACE_NAME_INFO **ppTable, _Inout_ PDWORD pdwCount, _In_ BOOL bOrder, _In_ HANDLE hHeap, _In_ DWORD dwFlags)

Function Documentation

NhGetGuidFromInterfaceName()

DWORD WINAPI NhGetGuidFromInterfaceName	(	_In_ PWCHAR	pInterfaceName,
		_Out_ GUID *	pInterfaceGUID,
		DWORD	dwUnknown3,
		DWORD	dwUnknown4
	)

Definition at line 3347 of file iphlpapi_main.c.

{
    WCHAR szGuidBuffer[45];
    UNICODE_STRING GuidString;
    HKEY hAdaptersKey = NULL, hAdapterKey = NULL, hConnectionKey = NULL;
    PWSTR pszNameBuffer = NULL;
    DWORD i, dwNameSize, dwValueSize;
    BOOL bFound = FALSE;
    DWORD result = ERROR_SUCCESS;
 
    result = RegOpenKeyExW(HKEY_LOCAL_MACHINE, L"SYSTEM\\CurrentControlSet\\Control\\Network\\{4D36E972-E325-11CE-BFC1-08002BE10318}", 0, KEY_READ, &hAdaptersKey);
    if (result != ERROR_SUCCESS)
    {
        // failed to find adapter entry
        return ERROR_NOT_FOUND;
    }
 
    for (i = 0; ; i++)
    {
        dwNameSize = ARRAYSIZE(szGuidBuffer);
        result = RegEnumKeyExW(hAdaptersKey,
                               i,
                               szGuidBuffer,
                               &dwNameSize,
                               NULL,
                               NULL,
                               NULL,
                               NULL);
        if (result != ERROR_SUCCESS)
            break;
 
        TRACE("Guid %S\n", szGuidBuffer);
 
        result = RegOpenKeyExW(hAdaptersKey, szGuidBuffer, 0, KEY_READ, &hAdapterKey);
        if (result == ERROR_SUCCESS)
        {
            result = RegOpenKeyExW(hAdapterKey, L"Connection", 0, KEY_READ, &hConnectionKey);
            if (result == ERROR_SUCCESS)
            {
                RegQueryValueExW(hConnectionKey, L"Name", NULL, NULL, NULL, &dwValueSize);
                pszNameBuffer = HeapAlloc(GetProcessHeap(), 0, dwValueSize);
                if (pszNameBuffer)
                {
                    RegQueryValueExW(hConnectionKey, L"Name", NULL, NULL, (PBYTE)pszNameBuffer, &dwValueSize);
 
                    TRACE("%S -- %S\n", pInterfaceName, pszNameBuffer);
                    if (_wcsnicmp(pInterfaceName, pszNameBuffer, wcslen(pszNameBuffer)) == 0)
                    {
                        TRACE("Found it!\n");
                        RtlInitUnicodeString(&GuidString, szGuidBuffer);
                        RtlGUIDFromString(&GuidString, pInterfaceGUID);
 
                        bFound = TRUE;
                    }
 
                    HeapFree(GetProcessHeap(), 0, pszNameBuffer);
                }
 
                RegCloseKey(hConnectionKey);
            }
 
            RegCloseKey(hAdapterKey);
        }
 
        if (bFound == TRUE)
            break;
    }
 
    RegCloseKey(hAdaptersKey);
 
    return bFound ? ERROR_SUCCESS : ERROR_NOT_FOUND;
}

Referenced by IpSetAddress().

NhGetInterfaceNameFromDeviceGuid()

DWORD WINAPI NhGetInterfaceNameFromDeviceGuid	(	_In_ const GUID *	pInterfaceGUID,
		_Out_writes_bytes_to_ *, *pOutBufLen PWCHAR	pInterfaceName,
		_Inout_ PULONG	pOutBufLen,
		DWORD	dwUnknown4,
		DWORD	dwUnknown5
	)

Definition at line 3315 of file iphlpapi_main.c.

{
    SetLastError(ERROR_SUCCESS);
 
    if (pInterfaceName == NULL)
        return ERROR_INVALID_PARAMETER;
 
    return GetInterfaceNameInternal(pInterfaceGUID, pInterfaceName, pOutBufLen);
}

Referenced by NsGetFriendlyNameFromIfName().

NhGetInterfaceNameFromGuid()

DWORD WINAPI NhGetInterfaceNameFromGuid	(	_In_ const GUID *	pInterfaceGUID,
		_Out_writes_bytes_to_ *, *pOutBufLen PWCHAR	pInterfaceName,
		_Inout_ PULONG	pOutBufLen,
		DWORD	dwUnknown4,
		DWORD	dwUnknown5
	)

Definition at line 3330 of file iphlpapi_main.c.

{
    DWORD result;
 
    result = GetInterfaceNameInternal(pInterfaceGUID, pInterfaceName, pOutBufLen);
 
    if (result == ERROR_NOT_FOUND)
        SetLastError(ERROR_PATH_NOT_FOUND);
 
    return result;
}

Referenced by IpDumpFn(), and IpShowAdapters().

NhpAllocateAndGetInterfaceInfoFromStack()

DWORD WINAPI NhpAllocateAndGetInterfaceInfoFromStack	(	_Inout_ IP_INTERFACE_NAME_INFO **	ppTable,
		_Inout_ PDWORD	pdwCount,
		_In_ BOOL	bOrder,
		_In_ HANDLE	hHeap,
		_In_ DWORD	dwFlags
	)

Referenced by IpDumpFn(), and IpShowAdapters().