ホーム › Security.Cryptography › BCryptProcessMultiOperationsFn

BCryptProcessMultiOperationsFn

コールバック

シグネチャ

NTSTATUS BCryptProcessMultiOperationsFn(
    BCRYPT_HANDLE hObject,
    BCRYPT_MULTI_OPERATION_TYPE operationType,
    void* pOperations,
    DWORD cbOperations,
    DWORD dwFlags
);

パラメーター

フィールド	型	説明
hObject	BCRYPT_HANDLE	BCRYPT_HANDLE `[in, out]` BCryptCreateMultiHash 関数などによって作成された、マルチオブジェクト状態へのハンドルです。
operationType	BCRYPT_MULTI_OPERATION_TYPE	BCRYPT_MULTI_OPERATION_TYPE `[in]` BCRYPT_OPERATION_TYPE_* 値のいずれかです。現在定義されている値は BCRYPT_OPERATION_TYPE_HASH のみです。この値は、hObject パラメーターがマルチハッシュオブジェクトであり、pOperations ポインターが BCRYPT_MULTI_HASH_OPERATION 要素の配列を指すことを示します。
pOperations	void*	PVOID `[in]` 操作コマンド構造体の配列へのポインターです。ハッシュの場合は、BCRYPT_MULTI_HASH_OPERATION 構造体の配列へのポインターです。
cbOperations	DWORD	ULONG `[in]` pOperations 配列のサイズ (バイト単位) です。
dwFlags	DWORD	ULONG `[in]` ゼロ (`0`) を指定します。

公式ドキュメント

BCryptProcessMultiOperations 関数は、マルチオブジェクト状態に対する一連の操作を処理します。

戻り値

関数の成功または失敗を示すステータスコードを返します。メソッドが成功した場合は STATUS_SUCCESS を返します。その他の NTSTATUS 値については、NTSTATUS Values を参照してください。

解説(Remarks)

pOperations 配列の各要素には、マルチオブジェクト状態の 1 つの要素に対して実行される特定の計算の指示が含まれます。BCryptProcessMultiOperations の機能的な動作は、マルチオブジェクト状態の各要素について、その要素に対する操作配列で指定された計算を、順に 1 つずつ実行することと同等です。

配列の異なる要素を操作する 2 つの操作どうしの相対的な順序は保証されません。出力バッファーが入力バッファーまたは出力バッファーと重なっている場合、結果は非決定的になります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)