共用方式為


RPC_ENDPOINT_TEMPLATE結構 (rpcdce.h)

RPC_ENDPOINT_TEMPLATE 結構會指定 RPC 介面群組伺服器端點的屬性,包括通訊協定順序和名稱。

語法

typedef struct {
  unsigned long Version;
  RPC_CSTR      ProtSeq;
  RPC_CSTR      Endpoint;
  void          *SecurityDescriptor;
  unsigned long Backlog;
} RPC_ENDPOINT_TEMPLATE, *PRPC_ENDPOINT_TEMPLATE;

成員

Version

此欄位是保留的,而且必須設定為 0。

ProtSeq

要向 RPC 執行時間連結庫註冊之通訊協定序列之字串標識碼的指標。 僅支持 ncalrpc、ncacn_ip_tcp 和 ncacn_np。 此值不得為 NULL

Endpoint

端點地址信息的選擇性指標,用於建立 Protseq 參數中所指定之通訊協定序列的系結。 指定 NULL 以使用動態端點。

SecurityDescriptor

為安全性子系統提供的選擇性參數指標。 僅用於 ncacn_np 和 ncalrpc 通訊協定序列。 所有其他通訊協定序列都會忽略此參數。 不建議在端點上使用安全描述項,以便讓伺服器安全。

Backlog

ncacn_ip_tcp通訊協定序列的待辦專案佇列長度。 所有其他通訊協定序列都會忽略此參數。 使用 RPC_C_PROTSEQ_MAX_REQS_DEFAULT 來指定預設值。 如需詳細資訊,請參閱「備註」。

備註

應用程式 在待辦 專案中提供的值只是提示。 RPC 執行時間或 Windows 套接字提供者可能會覆寫值。 例如,在 Windows XP 或 Windows 2000 Professional 上,此值限製為 5。 會忽略大於5的值,並改用5。 在 Windows Server 2003 和 Windows 2000 Server 上,將會接受此值。

應用程式必須小心,才能在 處理項目中傳遞合理的值。 伺服器、進階伺服器或 Datacenter Server 上的大值可能會導致使用大量的非分頁集區內存。 使用太小的值也不適合使用,因為如果待辦專案佇列耗盡,可能會導致來自伺服器的 TCP RST 符合 TCP SYN 封包。

當判斷 辦項目的適當值時,應用程式開發人員應該平衡記憶體使用量與延展性需求。

規格需求

需求
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
標頭 rpcdce.h (包含 Rpc.h)

另請參閱

RpcServerInqBindings