apisets.h File Reference

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

Go to the source code of this file.

Macros
#define	APISET_WIN7   (1 << 0)
#define	APISET_WIN8   (1 << 1)
#define	APISET_WIN81   (1 << 2)
#define	APISET_WIN10   (1 << 3)

Functions
NTSTATUS	ApiSetResolveToHost (_In_ DWORD ApisetVersion, _In_ PCUNICODE_STRING ApiToResolve, _Out_ PBOOLEAN Resolved, _Out_ PUNICODE_STRING Output)

Macro Definition Documentation

APISET_WIN10

#define APISET_WIN10   (1 << 3)

Definition at line 19 of file apisets.h.

APISET_WIN7

#define APISET_WIN7   (1 << 0)

Definition at line 16 of file apisets.h.

APISET_WIN8

#define APISET_WIN8   (1 << 1)

Definition at line 17 of file apisets.h.

APISET_WIN81

#define APISET_WIN81   (1 << 2)

Definition at line 18 of file apisets.h.

Function Documentation

ApiSetResolveToHost()

NTSTATUS ApiSetResolveToHost	(	_In_ DWORD	ApisetVersion,
		_In_ PCUNICODE_STRING	ApiToResolve,
		_Out_ PBOOLEAN	Resolved,
		_Out_ PUNICODE_STRING	Output
	)

Definition at line 32 of file apisets.c.

{
    if (ApiToResolve->Length < PrefixSize)
    {
        *Resolved = FALSE;
        return STATUS_SUCCESS;
    }
 
    // Grab the first four chars from the string, converting the first 3 to uppercase
    PWSTR ApiSetNameBuffer = ApiToResolve->Buffer;
    ULONGLONG ApiSetNameBufferPrefix = ((ULONGLONG *)ApiSetNameBuffer)[0] & 0xFFFFFFDFFFDFFFDF;
    // Check if it matches either 'api-' or 'ext-'
    if (!(ApiSetNameBufferPrefix == API_ || ApiSetNameBufferPrefix == EXT_))
    {
        *Resolved = FALSE;
        return STATUS_SUCCESS;
    }
 
    // If there is an extension, cut it off (we store apisets without extension)
    UNICODE_STRING Tmp = *ApiToResolve;
    const WCHAR *Extension = Tmp.Buffer + (Tmp.Length - ExtensionSize) / sizeof(WCHAR);
    if (!_wcsnicmp(Extension, L".dll", ExtensionSize / sizeof(WCHAR)))
        Tmp.Length -= ExtensionSize;
 
    // Binary search the apisets
    // Ideally we should use bsearch here, but that drags in another dependency and we do not want that here.
    LONG UBnd = g_ApisetsCount - 1;
    LONG LBnd = 0;
    while (LBnd <= UBnd)
    {
        LONG Index = (UBnd - LBnd) / 2 + LBnd;
 
        LONG result = RtlCompareUnicodeString(&Tmp, &g_Apisets[Index].Name, TRUE);
        if (result == 0)
        {
            // Check if this version is included
            if (g_Apisets[Index].dwOsVersions & ApisetVersion)
            {
                // Return a static string (does not have to be freed)
                *Resolved = TRUE;
                *Output = g_Apisets[Index].Target;
            }
            return STATUS_SUCCESS;
        }
        else if (result < 0)
        {
            UBnd = Index - 1;
        }
        else
        {
            LBnd = Index + 1;
        }
    }
    *Resolved = FALSE;
    return STATUS_SUCCESS;
}

Referenced by LdrpApplyFileNameRedirection(), resolve_fail_single(), and resolve_single().