RpcErrorAddRecord 関数 (rpcasync.h)
RpcErrorAddRecord 関数は、拡張エラー情報レコードのチェーンに拡張エラー情報を追加します。
構文
RPC_STATUS RpcErrorAddRecord(
[in] RPC_EXTENDED_ERROR_INFO *ErrorInfo
);
パラメーター
[in] ErrorInfo
RPC_EXTENDED_ERROR_INFO構造体の形式で追加するエラー情報。
戻り値
正常に完了すると、RPC_S_OKが返されます。
注釈
RpcErrorAddRecord 関数を使用すると、RPC ランタイム以外のアプリケーションまたはサーバーで、拡張エラー情報レコードのチェーンに拡張エラー情報を追加できます。
ErrorInfo が指す文字列の責任は、呼び出し元に属します。RpcErrorAddRecord 関数は、必要に応じて、これらの文字列のコピーを作成します。 ErrorInfo のメンバーに関する次の制限事項を確認する必要があります。
バージョン は、RPC_EEINFO_VERSIONなどの有効なバージョンに設定する必要があります。
ComputerName はNULL に設定する必要があります。 その他の値は、ERROR_INVALID_PARAMETERになります。
ProcessID は 0 に設定する必要があります。 その他の値は、ERROR_INVALID_PARAMETERになります。
SystemTime または FileTime は入力時に無視され、RPC ランタイムによって設定されます。
GeneratingComponent は 0 に設定する必要があります。 その他の値は、ERROR_INVALID_PARAMETERになります。 RPC ランタイムは、これを EEInfoGCApplication に設定します。
状態 は、呼び出し元がチェーンに追加するエラー コードに設定できます。
DetectionLocation は 0 に設定する必要があります。 その他の値は、ERROR_INVALID_PARAMETERになります。
NumberOfParameters は 、Parameters 配列内のパラメーターの数を示します。 この値は、0 以上または MaxNumberOfEEInfoParams である必要があります。 RPC ランタイムは、指定された数のパラメーターの後にメモリを使用しないため、呼び出し元は MaxNumberOfEEInfoParams パラメーター未満のメモリを安全に割り当てることができます。
Parameters は、拡張エラー情報レコードのパラメーターを表します。 パラメーターの唯一の制限は、 Pval がポインターを表すために使用され、常に 64 ビットであるということです。 使用されるシステムが 32 ビットか 64 ビットかに関係なく 、Pval を使用します。 Lval は使用しないでください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP [デスクトップ アプリ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | rpcasync.h (Rpc.h を含む) |
| Library | Rpcrt4.lib |
| [DLL] | Rpcrt4.dll |