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) |