PRESOURCE_TYPE_CONTROL_ROUTINE回调函数 (resapi.h)

执行应用于 资源类型的操作。 PRESOURCE_TYPE_CONTROL_ROUTINE类型定义指向此函数的指针。

语法

PRESOURCE_TYPE_CONTROL_ROUTINE PresourceTypeControlRoutine;

DWORD PresourceTypeControlRoutine(
  [in]  LPCWSTR ResourceTypeName,
  [in]  DWORD ControlCode,
  [in]  PVOID InBuffer,
  [in]  DWORD InBufferSize,
  [out] PVOID OutBuffer,
  [in]  DWORD OutBufferSize,
  [out] LPDWORD BytesReturned
)
{...}

parameters

[in] ResourceTypeName

要受操作影响的资源的类型。

[in] ControlCode

表示要执行的操作的控制代码。 有关 ControlCode 参数的有效值的列表，请参阅 资源类型控制代码。

[in] InBuffer

指向包含要用于操作的数据的缓冲区的指针。 如果操作不需要数据，InBuffer 可以为 NULL。

[in] InBufferSize

InBuffer 指向的缓冲区的大小（以字节为单位）。

[out] OutBuffer

指向包含操作生成的数据的缓冲区的指针。 如果操作不返回任何数据，则 OutBuffer 可以为 NULL。

[in] OutBufferSize

OutBuffer 指向的可用空间的大小（以字节为单位）。

[out] BytesReturned

OutBuffer 指向的缓冲区中实际包含数据的字节数。

返回值

如果操作成功，函数将返回 ERROR_SUCCESS。

如果操作失败，该函数将返回 系统错误代码。 下面是可能的错误代码。

返回代码	说明
ERROR_INVALID_FUNCTION	资源 DLL 请求 资源监视器 执行默认处理 (（如果有任何) ControlCode ）以及 DLL 提供的处理 (（如果有任何) ）。

注解

某些控制代码应由 资源 DLL 处理，而其他控制代码应由资源监视器处理。 有关 ResourceTypeControl 入口点函数的有效实现策略，请参阅 实现 ResourceTypeControl。

示例

请参阅 资源 DLL 示例。

要求

最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
目标平台	Windows
标头	resapi.h

请参阅

资源 DLL Entry-Point 函数