RPC_ENDPOINT_TEMPLATEA結構 （rpcdce.h）

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

語法

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

成員

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 Sockets 提供者可能會覆寫值。 例如，在 Windows XP 或 Windows 2000 Professional 上，此值限製為 5。 會忽略大於5的值，並改用5。 在 Windows Server 2003 和 Windows 2000 Server 上，將會接受此值。

應用程式必須小心，才能在 待辦專案中傳遞合理的值。 伺服器、進階伺服器或 Datacenter Server 上的大值可能會導致使用大量的非分頁集區內存。 使用太小的值也是不利的，因為它可能會導致 TCP SYN 封包在待辦專案佇列耗盡時，從伺服器符合 TCP SYN 封包。

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

注意

rpcdce.h 標頭會將 RPC_ENDPOINT_TEMPLATE 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求	價值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2012 [僅限傳統型應用程式]
標頭	rpcdce.h （包括 Rpc.h）

另請參閱

RpcServerInqBindings