RpcServerUseProtseqIf 函式 (rpcdce.h)
RpcServerUseProtseqIf 函式會指示 RPC 運行時間連結庫使用指定的通訊協定序列，結合介面規格中的端點來接收遠端過程調用。
語法
RPC_STATUS RpcServerUseProtseqIf(
RPC_CSTR Protseq,
unsigned int MaxCalls,
RPC_IF_HANDLE IfSpec,
void *SecurityDescriptor
);
參數
Protseq
要向 RPC 執行時間連結庫註冊的通訊協定序列字串標識子指標。
MaxCalls
ncacn_ip_tcp通訊協定序列的待辦專案佇列長度。 所有其他通訊協定序列都會忽略此參數。 使用 RPC_C_PROTSEQ_MAX_REQS_DEFAULT 來指定預設值。 請參閱＜備註＞。
IfSpec
介面，其中包含在建立 Protseq 參數中所指定通訊協定序列的系結時所使用的端點資訊。
SecurityDescriptor
為安全性子系統提供的選擇性參數指標。 僅用於 ncacn_np 和 ncalrpc 通訊協定序列。 所有其他通訊協定序列都會忽略此參數。 不建議在端點上使用安全性描述元，以確保伺服器安全。 此參數不會出現在此 API 的 DCE 規格中。
傳回值
| 值 | 意義 |
|---|---|
|
呼叫成功。 |
|
此通訊協定序列的端點未在IDL檔案中指定。 |
|
此主機不支援通訊協議順序。 |
|
通訊協議順序無效。 |
|
端點格式無效。 |
|
系統記憶體不足。 |
|
安全性描述元無效。 |
備註
伺服器應用程式會呼叫 RpcServerUseProtseqIf ，以向 RPC 運行時間連結庫註冊一個通訊協定序列。 透過每個通訊協定順序註冊，例程會包含IDL檔案中提供的端點位址資訊。
若要接收遠端過程調用要求，伺服器必須向 RPC 執行時間連結庫註冊至少一個通訊協定序列。 伺服器應用程式可以多次呼叫此函式，以註冊其他通訊協定序列。
針對伺服器註冊的每個通訊協定序列，RPC 運行時間連結庫會建立一或多個端點，讓伺服器接收遠端過程調用要求。 RPC 執行時間連結庫會為每個通訊協定序列建立不同的端點。 不過，進程中的每個介面都可以透過任何端點存取。 如需詳細資訊，請參閱撰寫安全的 RPC 用戶端或伺服器。
針對 MaxCalls，應用程式所提供的值只是提示。 RPC 運行時間或 Windows Sockets 提供者可能會覆寫值。 例如，在 Windows XP 或 Windows 2000 Professional 上，此值限製為 5。 忽略大於5的值，並改用5。 在 Windows Server 2003 和 Windows 2000 Server 上，將會接受此值。
應用程式必須小心，才能在 MaxCalls 中傳遞合理的值。 伺服器、進階伺服器或 Datacenter Server 上的大值可能會導致使用大量的非分頁集區內存。 使用太小的值也不適合使用，因為如果待辦專案佇列耗盡，可能會導致 TCP RST 從伺服器符合 TCP SYN 封包。 應用程式開發人員在判斷 MaxCalls的適當值時，應該平衡記憶體使用量與延展性需求。
當計算機設定為使用選擇性系結時，成功傳回不保證伺服器已為計算機上存在的所有網路介面建立端點。 RPC 運行時間可能不會接聽某些網路介面，視選擇性系結設定而定。 此外，如果介面尚未使用 DHCP 接收 IP 位址，RPC 伺服器就不會在網路介面上接聽，直到將 DHCP 位址指派給它為止。 成功傳回表示伺服器正在至少接聽一個網路介面;可以透過對 RpcServerInqBindings 函式的呼叫來取得遠端過程調用的完整系結句柄清單。
如需詳細資訊，請參閱 伺服器端系結。 如需 Microsoft RPC 支援的通訊協定序列清單，請參閱 字串系結。 若要從IDL檔案註冊所有通訊協定序列，伺服器會呼叫 RpcServerUseAllProtseqsIf。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | rpcdce.h (包含 Rpc.h) |
| 程式庫 | Rpcrt4.lib |
| Dll | Rpcrt4.dll |
另請參閱
撰寫安全的 RPC 用戶端或伺服器