共用方式為

RpcServerUseProtseqExW 函式 （rpcdce.h）

  • 發行項

RpcServerUseProtseqEx 函式會告訴 RPC 執行時間連結庫使用指定的通訊協定序列來接收遠端過程調用。

語法

RPC_STATUS RpcServerUseProtseqExW(
  RPC_WSTR     Protseq,
  unsigned int MaxCalls,
  void         *SecurityDescriptor,
  PRPC_POLICY  Policy
);

參數

Protseq

要向 RPC 執行時間連結庫註冊之通訊協定序列之字串標識碼的指標。

MaxCalls

ncacn_ip_tcp 通訊協定序列的待辦專案佇列長度。 所有其他通訊協定序列都會忽略此參數。 使用RPC_C_PROTSEQ_MAX_REQS_DEFAULT來指定預設值。 請參閱。

SecurityDescriptor

為 Windows XP/2000/NT 安全性子系統提供的選擇性參數指標。 僅適用於 ncacn_np 和 ncalrpc 通訊協定序列。 所有其他通訊協定序列都會忽略此參數。 不建議在端點上使用安全性描述元，以確保伺服器安全。 此參數不會出現在此 API 的 DCE 規格中。

Policy

RPC_POLICY 結構的指標，其中包含旗標以限制動態埠的埠配置，並允許多路計算機選擇性地系結至網路適配器。 RPC_POLICY 結構可讓呼叫端將 RPC 執行時間連結庫導向使用內部網路埠或因特網埠，以及其他選項。

傳回值

價值 意義
RPC_S_OK
 呼叫成功。
RPC_S_PROTSEQ_NOT_SUPPORTED
 此主機上不支援通訊協議順序。
RPC_S_INVALID_RPC_PROTSEQ
 通訊協議順序。
RPC_S_OUT_OF_MEMORY
 系統記憶體不足。
RPC_S_INVALID_SECURITY_DESC
 安全性描述元無效。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

言論

RpcServerUseProtseqEx 的參數和效果 子實例 RpcServerUseProtseq。 差異在於 [原則] 欄位，可讓您限制動態埠的埠配置，並允許多路計算機選擇性地系結至網路適配器。

將 NICFlagsRPC_POLICY 結構的欄位設定為零，讓此擴充函式在功能上相當於原始 RpcServerUseProtseq，而且伺服器會根據系統登錄中的設定系結至 NIC。 如需詳細資訊，請參閱 設定埠設定登錄和選擇性系結。

注意原則 欄位中的旗標設定只有在使用 ncacn_ip_tcp 或 ncadg_ip_udp 通訊協定順序時才有效。 針對所有其他通訊協定序列，RPC 運行時間會忽略這些值。
 
伺服器應用程式會呼叫 RpcServerUseProtseqEx，以向 RPC 運行時間連結庫註冊一個通訊協定序列。 若要接收遠端過程調用要求，伺服器必須向 RPC 執行時間連結庫註冊至少一個通訊協定序列。 伺服器應用程式可以呼叫 RpcServerUseProtseqEx 多次，以註冊額外的通訊協定序列。

針對伺服器註冊的每個通訊協定序列，RPC 運行時間連結庫會建立一或多個端點，讓伺服器接收遠端過程調用要求。 RPC 執行時間連結庫會為每個通訊協定序列建立不同的端點。 端點名稱是由 RPC 執行時間或作業系統所產生。 例如，針對 ncacn_ip_tcp，埠號碼會根據可用性和登錄設定，由 RPC 運行時間動態決定。

針對 MaxCalls，應用程式所提供的值只是提示。 RPC 運行時間或 Windows Sockets 提供者可能會覆寫值。 例如，在 Windows XP 或 Windows 2000 Professional 上，此值限製為 5。 會忽略大於5的值，並改用5。 在 Windows Server 2003 和 Windows 2000 Server 上，將會接受此值。

應用程式必須小心，才能在 maxCalls 中傳遞合理的值。 伺服器、進階伺服器或 Datacenter Server 上的大值可能會導致使用大量的非分頁集區內存。 使用太小的值也是不利的，因為它可能會導致 TCP SYN 封包在待辦專案佇列耗盡時，從伺服器符合 TCP SYN 封包。 在判斷 maxCalls 的適當值時，應用程式開發人員應平衡記憶體使用量與延展性需求。

當計算機設定為使用選擇性系結時，成功傳回不保證伺服器已為計算機上所有網路介面建立端點。 RPC 運行時間可能不會根據選擇性系結設定來接聽某些網路介面。 此外，如果介面尚未使用 DHCP 接收 IP 位址，則 RPC 伺服器在指派 DHCP 位址之前，不會接聽網路介面。 成功的傳回表示伺服器正在至少接聽一個網路介面;可以透過 RpcServerInqBindings 函式呼叫來取得遠端過程調用的完整系結句柄清單。

若要註冊所有通訊協定序列，伺服器會呼叫 RpcServerUseAllProtseqsEx 例程。

如需詳細資訊，請參閱 Server-Side 系結。

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 rpcdce.h （包括 Rpc.h）
連結庫 Rpcrt4.lib
DLL Rpcrt4.dll

另請參閱

RpcServerUseAllProtseqsEx

RpcServerUseAllProtseqsIfEx

RpcServerUseProtseqEpEx

RpcServerUseProtseqIfEx