如何创建与使用IBuffer？适配Winapi加密算法提供者参数需求

1. 核心认知 #

IBuffer是WinRT定义的二进制数据存储接口，并非原生内存指针，无法直接传入PWideChar这类原生类型，必须通过WinRT标准API完成数据的转换与填充。

2. 实用实现方法 #

方法一：从字节数组快速创建IBuffer #

如果你的数据是字符串或已存在的字节数组，优先用CryptographicBuffer.CreateFromByteArray完成转换：

var
  ContentBytes: TArray<Byte>;
  InputBuffer: IBuffer;
  SourceStr: string;
begin
  // 将目标字符串转为UTF-8字节数组（根据算法要求选择编码）
  SourceStr := '需要处理的内容';
  ContentBytes := TEncoding.UTF8.GetBytes(SourceStr);
  
  // 生成符合要求的IBuffer
  if not CryptographicBuffer.CreateFromByteArray(ContentBytes, InputBuffer) then
    RaiseLastOSError;
    
  // 此时InputBuffer可直接传入Core_IAsymmetricKeyAlgorithmProvider的目标函数
end;

方法二：适配原生PWideChar场景 #

如果你的数据存储在PWideChar指向的宽字符内存中，先将其转为字节数组再创建IBuffer：

var
  WidePtr: PWideChar;
  StrLength: Integer;
  ContentBytes: TArray<Byte>;
  InputBuffer: IBuffer;
begin
  WidePtr := '你的宽字符串指针';
  StrLength := lstrlenW(WidePtr);
  
  // 宽字符占2字节，计算总字节数并分配数组
  SetLength(ContentBytes, StrLength * SizeOf(WideChar));
  Move(WidePtr^, ContentBytes[0], StrLength * SizeOf(WideChar));
  
  // 生成IBuffer
  if not CryptographicBuffer.CreateFromByteArray(ContentBytes, InputBuffer) then
    RaiseLastOSError;
end;

方法三：直接操作IBuffer内存 #

若需要预先分配空IBuffer再写入数据，可通过IBufferByteAccess接口直接获取内存指针：

uses
  Winapi.Windows, Winapi.Security.Cryptography, System.SysUtils;

var
  InputBuffer: IBuffer;
  ByteAccess: IBufferByteAccess;
  DataPtr: PByte;
  WidePtr: PWideChar;
  StrLength: Integer;
begin
  // 创建指定大小的空IBuffer
  InputBuffer := CryptographicBuffer.CreateFromByteArray(nil);
  InputBuffer.Length := 1024; // 根据实际需求设置大小
  
  // 获取IBuffer的内存访问接口
  if InputBuffer.QueryInterface(IID_IBufferByteAccess, ByteAccess) = S_OK then
  begin
    ByteAccess.Buffer(@DataPtr);
    
    // 直接向内存写入PWideChar数据
    WidePtr := '你的宽字符串指针';
    StrLength := lstrlenW(WidePtr);
    Move(WidePtr^, DataPtr^, StrLength * SizeOf(WideChar));
  end;
end;

3. 关键注意事项 #

• 必须引入依赖单元：Winapi.Security.Cryptography、System.SysUtils
• 严格匹配算法要求的输入编码（如UTF-8/UTF-16），避免数据乱码
• WinRT接口自动管理引用计数，无需手动释放，但需确保接口调用成功（通过返回值判断）

内容的提问来源于stack exchange，提问作者MeroFuruya