IDebugDataSpaces2::ReadHandleData メソッド (dbgeng.h)

ReadHandleData メソッドは、システム ハンドルによって指定されたシステム オブジェクトに関する情報を取得します。

構文

HRESULT ReadHandleData(
  [in]            ULONG64 Handle,
  [in]            ULONG   DataType,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  DataSize
);

パラメーター

[in] Handle

データが要求されるオブジェクトのシステム ハンドルを指定します。 システム ハンドルの詳細については、「ハンドル」を参照してください。

[in] DataType

システム ハンドルに返すデータ型を指定します。 次の表に、有効な値と、対応する戻り値の型を示します。

値	説明
DEBUG_HANDLE_DATA_TYPE_BASIC	システム オブジェクトに関する基本情報を返します。 この場合、 引数 Buffer には型 PDEBUG_HANDLE_DATA_BASICがあると見なすことができます。
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME	オブジェクト型の名前を返します。 たとえば、"Process" や "Thread" などです。 この場合、引数 Buffer は PSTR 型と見なすことができます。
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME	オブジェクトの名前を返します。 これには、オブジェクト ディレクトリ内の場所が含まれます。 この場合、引数 Buffer は PSTR 型と見なすことができます。
DEBUG_HANDLE_DATA_TYPE_HANDLE_COUNT	オブジェクトが保持するハンドルの数を返します。 これは、フィールド DEBUG_HANDLE_DATA_BASICに似ています。HandleCount。 この場合、引数 Buffer は PULONG 型と見なすことができます。
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME_WIDE	オブジェクト型の名前を返します。 この場合、引数 Buffer は PWSTR 型と見なすことができます
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME_WIDE	オブジェクトの名前を返します。 この場合、引数 Buffer は PWSTR 型と見なすことができます。

[out, optional] Buffer

オブジェクト データを受信します。 メソッドが正常に完了すると、このバッファーの内容にアクセスするには、 Buffer を上記 の表で指定された型にキャストします。

Buffer が NULL の場合、この情報は返されません。

[in] BufferSize

バッファー バッファーのサイズをバイト単位で指定 します。 これは、返される最大バイト数です。

[out, optional] DataSize

データのサイズをバイト単位で受け取ります。 DataSize が NULL の場合、この情報は返されません。

戻り値

リターン コード	説明
S_OK	メソッドは正常に実行されました。

 

このメソッドは、エラー値を返すこともできます。 詳細については、「 戻り値 」を参照してください。

注釈

このメソッドは、ユーザー モード デバッグでのみ使用できます。

要件

要件	値
対象プラットフォーム	デスクトップ
Header	dbgeng.h (Dbgeng.h を含む)

こちらもご覧ください

ハンドル

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4