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 は使用しないでください。

要件

こちらもご覧ください

拡張 RPC エラー情報の取得

RPC_EXTENDED_ERROR_INFO

RpcErrorGetNextRecord

RpcErrorStartEnumeration