共用方式為

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