共用方式為

IDebugDataSpaces4：：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 轉換成上表中指定的類型來存取。

如果 緩衝區NULL，則不會傳回此資訊。

[in] BufferSize

指定緩衝區的大小，以位元組為單位，Buffer。 這是將傳回的最大位元元組數目。

[out, optional] DataSize

接收以位元組為單位的數據大小。 如果 DataSizeNULL，則不會傳回此資訊。

傳回值

傳回碼 描述
S_OK
 方法成功。
 

這個方法也可以傳回錯誤值。 如需詳細資訊，請參閱 傳回值。

言論

這個方法只能在使用者模式偵錯中使用。

要求

要求 價值
目標平臺 桌面
標頭 dbgeng.h （include Dbgeng.h）

另請參閱

處理

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4