BCRYPT_DH_PARAMETER_HEADER

BCRYPT_DH_PARAMETER_HEADER 構造体は、Diffie-Hellman キーのパラメーターヘッダー情報を格納するために使用されます。この構造体は、BCRYPT_DH_PARAMETERS プロパティと共に BCryptSetProperty 関数で使用されます。

この構造体は、より大きなバッファーのヘッダーとして使用されます。単一のメモリブロックは、この構造体に続いて、Diffie-Hellman の素数を格納する cbKeyLength サイズのバッファー、さらに Diffie-Hellman のジェネレーター値を格納する cbKeyLength サイズのバッファーで構成されます。これらの数値はいずれもビッグエンディアン形式です。

次の例は、このバッファーに必要なサイズを計算する方法と、この構造体のメンバーを設定する方法を示しています。

// In this example, the rgbModulus variable is a byte array that contains the modulus in big-endian byte order. 
// The rgbGenerator variable is a byte array that contains the generator in big-endian byte order.

ULONG cbDHParams = sizeof(BCRYPT_DH_PARAMETER_HEADER) +     (cbKeySize * 2);
PBYTE pbDHParams = (PBYTE)malloc(cbDHParams);
if(!pbDHParams)
{
    status = STATUS_NO_MEMORY;
    goto Cleanup;
}

BCRYPT_DH_PARAMETER_HEADER *pDHParamHeader;
pDHParamHeader = (BCRYPT_DH_PARAMETER_HEADER*)pbDHParams;
pDHParamHeader->cbLength = cbDHParams;
pDHParamHeader->cbKeyLength = cbKeySize;
pDHParamHeader->dwMagic = BCRYPT_DH_PARAMETERS_MAGIC;

// Add the modulus to the parameters.
// The rgbModulus argument is a byte array that contains the modulus.
PBYTE pbTemp = (PBYTE)pbDHParams + sizeof(BCRYPT_DH_PARAMETER_HEADER);
CopyMemory(pbTemp, rgbModulus, pDHParamHeader->cbKeyLength);

// Add the generator to the parameters.
// The rgbGenerator argument is a byte array that contains the generator.
pbTemp += pDHParamHeader->cbKeyLength;
CopyMemory(pbTemp, rgbGenerator, pDHParamHeader->cbKeyLength);