DismGetLastErrorMessage 函数

在失败后立即获取当前线程中的错误消息。

语法

HRESULT WINAPI DismGetLastErrorMessage(
  _Out_ DismString **ErrorMessage
);

参数

ErrorMessage [out]
当前线程中的详细错误消息。

返回值

如果成功,则返回 S_OK。

注解

在 DISM API 失败后,可立即获取详细的错误消息。 最后一个错误消息是基于每线程进行维护的。 一个线程上的错误消息将不会覆盖另一个线程上的最后一条错误消息。

DismGetLastErrorMessage 不适用于 DismShutdown 函数、DismDelete 函数或 DismGetLastErrorMessage 函数。

当返回值为 S_OK 时,必须调用 DismDelete 函数来释放 ErrorMessage 的内存。

示例

HRESULT hr = S_OK;
DismString* ErrorMessage;
hr = DismGetLastErrorMessage(&ErrorMessage);

要求

要求 说明
支持的主机平台 DISM API 可在 Windows 评估和部署工具包 (Windows ADK) 支持的任何操作系统上使用。 有关详细信息,请参阅 Windows ADK 技术参考
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
标头 DismAPI.h
Library DismAPI.lib
DLL DismAPI.dll

另请参阅

DISM API 疑难解答