WdsCliGetImageHalName 函式 (wdsclientapi.h)

傳回目前影像的硬體抽象層 (HAL) 名稱。

語法

HRESULT WDSCLIAPI WdsCliGetImageHalName(
  [in]  HANDLE hIfh,
  [out] PWSTR  *ppwszValue
);

[in] hIfh

WdsCliFindFirstImage函式所傳回的尋找控制碼。尋找控制碼所參考的影像可以使用 WdsCliFindNextImage 函式進行進階。

[out] ppwszValue

指標，指向包含目前影像之 HAL 名稱之 Null 終止字串值的指標。

如果函式成功，則傳回會 S_OK。

此值有效，直到 WdsCliFindNextImage 或 WdsCliClose 函式用來變更或關閉目前的控制碼為止。