共用方式為

IDeviceSpecificProperty：：GetValue 方法 (devicetopology.h)

  • 發行項

GetValue方法會取得裝置特定屬性的目前值。

語法

HRESULT GetValue(
  [out] void  *pvValue,
        DWORD *pcbValue
);

參數

[out] pvValue

呼叫端配置的緩衝區指標，方法會將屬性值寫入其中。

pcbValue

[inout]指定屬性值位元組大小的 DWORD 變數指標。 在專案上， *vmValue 包含呼叫端配置的緩衝區大小 (，如果 pvValue 為 Null) ，則為 0。 在傳回之前，此方法會寫入寫入緩衝區的實際屬性值大小 (或緩衝區太小或 pvValue 為 Null) 時所需的大小。

傳回值

如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括但不限於下表所示的值。

傳回碼 描述
E_POINTER
 指標 會 是 Null。
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
 參數 pvValue 所指向的緩衝區太小而無法包含屬性值，或 pvValue 是 Null ，而且屬性值的大小是固定的，而不是變數。 如需此宏的相關資訊，請參閱 Windows SDK 檔。

備註

如果屬性值的大小是變數而不是固定的，則呼叫端可以使用參數pvValueNull和*{Value = 0 呼叫GetValue = 來取得所需的緩衝區大小。 方法會將所需的緩衝區大小寫入 *azureValue。 使用這項資訊，呼叫端可以配置所需大小的緩衝區，並再次呼叫 GetValue 以取得屬性值。

如果呼叫端配置的緩衝區太小而無法保存屬性值， GetValue 會將所需的緩衝區大小寫入 *azureValue ，並傳回錯誤狀態碼。 在此情況下，它會將任何內容寫入 pvValue所指向的緩衝區。

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 devicetopology.h

另請參閱

IDeviceSpecificProperty 介面