WDS_TRANSPORTCLIENT_REQUEST 结构 (wdstci.h)

WdsTransportClientStartSession 函数使用此结构。

语法

typedef struct _WDS_TRANSPORTCLIENT_REQUEST {
  ULONG   ulLength;
  ULONG   ulApiVersion;
  ULONG   ulAuthLevel;
  LPCWSTR pwszServer;
  LPCWSTR pwszNamespace;
  LPCWSTR pwszObjectName;
  ULONG   ulCacheSize;
  ULONG   ulProtocol;
  PVOID   pvProtocolData;
  ULONG   ulProtocolDataLength;
} WDS_TRANSPORTCLIENT_REQUEST, *PWDS_TRANSPORTCLIENT_REQUEST;

成员

ulLength

此结构的长度（以字节为单位）。

ulApiVersion

调用方所基于的 API 版本。 多播客户端可能会基于此值拒绝请求。

此成员必须包含以下值。

值	含义
WDS_TRANSPORT_CLIENT_CURRENT_API_VERSION 1	当前的版本。

ulAuthLevel

此成员可以包含以下值之一。

值	含义
WDS_TRANSPORTCLIENT_AUTH 0x1	有关此用户的身份验证信息将发送到服务器。 服务器将使用此信息来确定用户是否有权访问此文件。
WDS_TRANSPORTCLIENT_NO_AUTH 0x2	不会向服务器发送任何身份验证信息。 如果未将服务器配置为接受这些请求，则请求将失败。

pwszServer

服务器名称。

pwszNamespace

要检索的 对象的命名空间。

pwszObjectName

指定要检索的对象的名称。 对象名称依赖于提供程序。

ulCacheSize

指定使用者在其队列中可以存储多少数据（以字节为单位）。 达到此阈值后，在 WdsTransportClientCompleteWrite 释放某些内存之前，客户端不会再向使用者发送写入。

ulProtocol

指定要用于此传输的协议。

此成员可以包含以下值。

值	含义
WDS_TRANSPORTCLIENT_PROTOCOL_MULTICAST 0x00000001	将使用高效的多播协议传输文件。

pvProtocolData

协议的协议数据结构。 对于WDS_TRANSPORTCLIENT_PROTOCOL_MULTICAST协议，结构为 NULL。

ulProtocolDataLength

pvProtocolData 指向的协议数据的长度。

要求

最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	wdstci.h