共用方式為

RpcMgmtEpEltInqNextA 函式 （rpcdce.h）

  • 發行項

RpcMgmtEpEltInqNext 函式會從端點對應傳回一個專案。

語法

RPC_STATUS RpcMgmtEpEltInqNextA(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  UUID               *ObjectUuid,
  RPC_CSTR           *Annotation
);

參數

InquiryContext

指定查詢內容。 查詢內容會從 RpcMgmtEpEltInqBegin傳回。

IfId

傳回端點對應專案的介面標識碼。

Binding

自選。 從端點對應專案傳回系結句柄。

ObjectUuid

自選。 從端點對應專案傳回物件 UUID。

Annotation

自選。 傳回 endpoint-map 元素的註釋字串。 當端點對應元素中沒有註釋字串時，會傳回空字串 （“”） 。

傳回值

價值 意義
RPC_S_OK
 呼叫成功。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

言論

RpcMgmtEpEltInqNext 函式會從端點對應傳回一個專案。 選取的專案取決於查詢內容。 選取準則是由傳回 InquiryContext之 rpcMgmtEpEltInqBegin 函式的 InquiryType 所決定。

應用程式可以重複呼叫 rpcMgmtEpEltInqNext 來檢視所有選取的端點對應專案。 檢視所有元素時，此函式會傳回RPC_X_NO_MORE_ENTRIES狀態。 傳回的專案未排序。

當個別自變數為非 NULL 時，RPC 執行時間函式連結庫會在每次呼叫此函式時，配置 Binding 和 Annotation 記憶體。 應用程式負責針對每個傳回 系結 和針對每個傳回 註釋傳回的 RpcStringFree 呼叫 RpcBindingFree。

檢視端點對應項目之後，應用程式必須呼叫 RpcMgmtEpEltInqDone，以刪除查詢內容。

注意

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

要求

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

另請參閱

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone