RpcMgmtInqIfIds 函式 (rpcdce.h)

  • 發行項

RpcMgmtInqIfIds函式會傳回包含伺服器所提供介面識別碼的向量。

語法

RPC_STATUS RpcMgmtInqIfIds(
  RPC_BINDING_HANDLE Binding,
  RPC_IF_ID_VECTOR   **IfIdVector
);

參數

Binding

若要接收遠端應用程式的介面識別碼，請指定該應用程式的伺服器系結控制碼。 若要接收您自己的應用程式的相關介面資訊，請指定 Null的值。

IfIdVector

傳回介面識別碼向量的位址。

傳回值

值 意義
RPC_S_OK
 呼叫成功。
RPC_S_INVALID_BINDING
 系結控制碼無效。
RPC_S_WRONG_KIND_OF_BINDING
 這是作業的系結錯誤種類。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

備註

應用程式會呼叫 RpcMgmtInqIfIds 函式，從 RPC 執行時間程式庫取得有關指定伺服器的介面識別碼向量。

RPC 執行時間程式庫會配置介面識別碼向量的記憶體。 應用程式負責呼叫 RpcIfIdVectorFree 函式，以釋放此向量所使用的記憶體。

伺服器必須接聽遠端程序呼叫，此函式才能成功。 如果伺服器未接聽，則函式會失敗。

需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 rpcdce.h (包含 Rpc.h)
程式庫 Rpcrt4.lib
Dll Rpcrt4.dll

另請參閱

RpcIfIdVectorFree