Share via


OALIoCtlHalGetRegSecureKeys (Compact 2013)

10/16/2014

This function implements a common IOCTL_HAL_GETREGSECUREKEYS (deprecated) handler.

OALIoCtlHalGetRegSecureKeys enables the OEM to extend the list of registry paths that should be protected from nontrusted applications.

Syntax

BOOL OALIoCtlHalGetRegSecureKeys(
  UINT32 dwIoControlCode,
  VOID* lpInBuf,
  UINT32 nInBufSize,
  VOID* lpOutBuf,
  UINT32 lpOutBufSize,
  UINT32* lpBytesReturned
);

Parameters

  • dwIoControlCode
    [in] Set to IOCTL_HAL_GETREGSECUREKEYS.
  • lpInBuf
    [in]Set to NULL.
  • nInBufSize
    [in] Set to zero.
  • lpOutBuf
    [out] Pointer to a buffer that stores either a RegSecureKeyList structure provided by the OEM or a DWORD.
  • lpOutBufSize
    [in] Size of the lpOutBuf parameter.

    If the size specified by lpOutBufSize is equal to sizeof(DWORD), Filesys.exe is requesting the amount of memory it needs to allocate to store the data to be returned by the OEM. Set the DWORD pointed to by lpOutBuf to the number of bytes that must be allocated by Filesys.exe to retrieve the data.

    If the DWORD pointer specified in lpOutBuf is set to zero, no further action is taken by Filesys.exe.

  • lpBytesReturned
    [in] Pointer to UINT32 that stores the number of bytes written to the lpBuffer.

Return Value

TRUE indicates success.

FALSE indicates failure.

Requirements

Header

oal_ioctl.h

Library

Developer Implemented

See Also

Reference

IOCTL Functions