ISCPSecureQuery：：GetDataDemands 方法 (mswmdm.h)
GetDataDemands 方法报告安全内容提供程序确定指定内容的权限和责任所需的数据。
语法
HRESULT GetDataDemands(
[out] UINT *pfuFlags,
[out] DWORD *pdwMinRightsData,
[out] DWORD *pdwMinExamineData,
[out] DWORD *pdwMinDecideData,
[in, out] BYTE [8] abMac
);
参数
[out] pfuFlags
描述安全内容提供程序做出决策所需的数据的标志。 此参数包含在输出消息身份验证代码中。 必须至少使用以下标志之一。
| 标志 | 描述 |
|---|---|
| WMDM_SCP_RIGHTS_DATA | 安全内容提供程序需要数据来确定内容的权限。 |
| WMDM_SCP_EXAMINE_DATA | 安全内容提供程序需要数据来确定它是否对内容负责。 |
| WMDM_SCP_DECIDE_DATA | 安全内容提供程序需要数据来确定是否允许下载内容。 |
| WMDM_SCP_EXAMINE_EXTENSION | 安全内容提供程序需要检查文件扩展名，以确定是否允许下载内容。 |
| WMDM_SCP_PROTECTED_OUTPUT | 安全内容提供程序需要受保护的输出。 |
| WMDM_SCP_UNPROTECTED_OUTPUT | 安全内容提供程序需要不受保护的输出。 |
[out] pdwMinRightsData
指向 DWORD 的指针，指定确定此内容权限所需的最小数据量。 此参数包含在输出消息身份验证代码中。
[out] pdwMinExamineData
指向 DWORD 的指针，其中包含安全内容提供程序确定是否负责内容所需的最小字节数的数据。 此参数包含在输出消息身份验证代码中。
[out] pdwMinDecideData
指向包含安全内容提供程序确定是否允许下载内容的最小字节数数据的 DWORD 的指针。 此参数包含在输出消息身份验证代码中。
[in, out] abMac
包含此方法参数数据的消息身份验证代码的八个字节的数组。 (WMDM_MAC_LENGTH 定义为 8.)
返回值
如果该方法成功，则它会返回 S_OK。 如果失败，则返回 HRESULT 错误代码。
| 返回代码 | 说明 |
|---|---|
|
消息身份验证代码无效。 |
|
参数是无效的或 NULL 指针。 |
|
发生了未指定的错误。 |
注解
必须先调用此方法，然后才能调用 ISCPSecureQuery 的任何其他方法。
在成功完成任何证书交换后，将调用此方法。 安全内容提供程序使用标记和数据填充参数，这些标志和数据描述其针对内容做出决策的要求。
如果安全内容提供程序设置WMDM_SCP_RIGHTS_DATA标志，则 Windows Media 设备管理器通过调用 ISCPSecureQuery：：GetRights 发送 pdwMinRightsData 中指定的数据量。
如果安全内容提供程序设置WMDM_SCP_EXAMINE_DATA标志，则 Windows Media 设备管理器通过调用 ISCPSecureQuery：：ExamineData 发送 pdwMinExamineData 中指定的数据量。
如果安全内容提供程序设置WMDM_SCP_DECIDE_DATA标志，则 Windows Media 设备管理器通过调用 ISCPSecureQuery：：MakeDecision 发送 pdwMinDecideData 中指定的数据量。
如果未设置检查标志，则 Windows Media 设备管理器 不会再发出任何调用。 如果未设置决定标志，Windows Media 设备管理器仍调用 ISCPSecureQuery：：ExamineData。
如果此方法不返回S_OK，则 Windows Media 设备管理器 不会对此安全内容提供程序进行任何进一步调用。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | mswmdm.h |
| Library | Mssachlp.lib |