RpcErrorAddRecord 関数 (rpcasync.h)

RpcErrorAddRecord 関数は、拡張エラー情報レコードのチェーンに拡張エラー情報を追加します。

構文

RPC_STATUS RpcErrorAddRecord(
  [in] RPC_EXTENDED_ERROR_INFO *ErrorInfo
);

パラメーター

[in] ErrorInfo

RPC_EXTENDED_ERROR_INFO構造体の形式で追加するエラー情報。

戻り値

正常に完了すると、RPC_S_OKが返されます。

メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。

 

注釈

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

こちらもご覧ください

拡張 RPC エラー情報の取得

RPC_EXTENDED_ERROR_INFO

RpcErrorGetNextRecord

RpcErrorStartEnumeration