firmware.c File Reference

#include <ndk/exfuncs.h>
#include "k32_vista.h"

Include dependency graph for firmware.c:

Go to the source code of this file.

Macros
#define	NTDDI_VERSION   NTDDI_VISTA

Functions
	_Success_ (return, 0)
BOOL WINAPI	SetFirmwareEnvironmentVariableExW (_In_ LPCWSTR lpName, _In_ LPCWSTR lpGuid, _In_reads_bytes_opt_(nSize) PVOID pValue, _In_ DWORD nSize, _In_ DWORD dwAttributes)
BOOL WINAPI	SetFirmwareEnvironmentVariableExA (_In_ LPCSTR lpName, _In_ LPCSTR lpGuid, _In_reads_bytes_opt_(nSize) PVOID pValue, _In_ DWORD nSize, _In_ DWORD dwAttributes)
	_Success_ (return)

Macro Definition Documentation

NTDDI_VERSION

#define NTDDI_VERSION   NTDDI_VISTA

Definition at line 10 of file firmware.c.

Function Documentation

_Success_() [1/2]

_Success_

(

return

= = 0

)

Definition at line 203 of file firmware.c.

{
    NTSTATUS Status;
    SYSTEM_BOOT_ENVIRONMENT_INFORMATION BootInfo;
 
    /* Check input parameters */
    if (FirmwareType == NULL)
    {
        SetLastError(ERROR_INVALID_PARAMETER);
        return FALSE;
    }
 
    /* Query firmware type */
    Status = NtQuerySystemInformation(SystemBootEnvironmentInformation,
                                      &BootInfo,
                                      sizeof(BootInfo),
                                      0);
    if (!NT_SUCCESS(Status))
    {
        BaseSetLastNTError(Status);
        return FALSE;
    }
 
    *FirmwareType = BootInfo.FirmwareType;
    return TRUE;
}

_Success_() [2/2]

_Success_	(	return	,
		0
	)

Definition at line 15 of file firmware.c.

{
    NTSTATUS Status;
    UNICODE_STRING VariableName, Namespace;
    GUID VendorGuid;
    ULONG Length;
 
    /* Check input parameters and build NT strings */
    if (!lpName || !lpGuid)
    {
        SetLastError(ERROR_INVALID_PARAMETER);
        return 0;
    }
    RtlInitUnicodeString(&VariableName, lpName);
    RtlInitUnicodeString(&Namespace, lpGuid);
    Status = RtlGUIDFromString(&Namespace, &VendorGuid);
    if (!NT_SUCCESS(Status))
    {
        BaseSetLastNTError(Status);
        return 0;
    }
 
    /* Query firmware system environment variable value */
    Length = nSize;
    Status = NtQuerySystemEnvironmentValueEx(&VariableName,
                                             &VendorGuid,
                                             pBuffer,
                                             &Length,
                                             pdwAttribubutes);
    if (!NT_SUCCESS(Status))
    {
        BaseSetLastNTError(Status);
        return 0;
    }
 
    return Length;
}

SetFirmwareEnvironmentVariableExA()

BOOL WINAPI SetFirmwareEnvironmentVariableExA	(	_In_ LPCSTR	lpName,
		_In_ LPCSTR	lpGuid,
		_In_reads_bytes_opt_(nSize) PVOID	pValue,
		_In_ DWORD	nSize,
		_In_ DWORD	dwAttributes
	)

Definition at line 156 of file firmware.c.

{
    NTSTATUS Status;
    BOOL Result;
    UNICODE_STRING VariableName, Namespace;
    ANSI_STRING AnsiVariableName, AnsiNamespace;
 
    /* Check input parameters and build NT strings */
    if (!lpName || !lpGuid)
    {
        SetLastError(ERROR_INVALID_PARAMETER);
        return FALSE;
    }
    RtlInitString(&AnsiVariableName, lpName);
    Status = RtlAnsiStringToUnicodeString(&VariableName, &AnsiVariableName, TRUE);
    if (!NT_SUCCESS(Status))
    {
        BaseSetLastNTError(Status);
        return FALSE;
    }
    RtlInitString(&AnsiNamespace, lpGuid);
    Status = RtlAnsiStringToUnicodeString(&Namespace, &AnsiNamespace, TRUE);
    if (!NT_SUCCESS(Status))
    {
        RtlFreeUnicodeString(&VariableName);
        BaseSetLastNTError(Status);
        return FALSE;
    }
 
    /* Call unicode version interface */
    Result = SetFirmwareEnvironmentVariableExW(VariableName.Buffer,
                                               Namespace.Buffer,
                                               pValue,
                                               nSize,
                                               dwAttributes);
 
    /* Cleanup and return */
    RtlFreeUnicodeString(&Namespace);
    RtlFreeUnicodeString(&VariableName);
    return Result;
}

Referenced by SetFirmwareEnvironmentVariableA().

SetFirmwareEnvironmentVariableExW()

BOOL WINAPI SetFirmwareEnvironmentVariableExW	(	_In_ LPCWSTR	lpName,
		_In_ LPCWSTR	lpGuid,
		_In_reads_bytes_opt_(nSize) PVOID	pValue,
		_In_ DWORD	nSize,
		_In_ DWORD	dwAttributes
	)

Definition at line 113 of file firmware.c.

{
    NTSTATUS Status;
    UNICODE_STRING VariableName, Namespace;
    GUID VendorGuid;
 
    /* Check input parameters and build NT strings */
    if (!lpName || !lpGuid)
    {
        SetLastError(ERROR_INVALID_PARAMETER);
        return FALSE;
    }
    RtlInitUnicodeString(&VariableName, lpName);
    RtlInitUnicodeString(&Namespace, lpGuid);
    Status = RtlGUIDFromString(&Namespace, &VendorGuid);
    if (!NT_SUCCESS(Status))
    {
        BaseSetLastNTError(Status);
        return FALSE;
    }
 
    /* Set firmware system environment variable value */
    Status = NtSetSystemEnvironmentValueEx(&VariableName,
                                           &VendorGuid,
                                           pValue,
                                           nSize,
                                           dwAttributes);
    if (!NT_SUCCESS(Status))
    {
        BaseSetLastNTError(Status);
        return FALSE;
    }
 
    return TRUE;
}

Referenced by SetFirmwareEnvironmentVariableExA(), and SetFirmwareEnvironmentVariableW().