rpcMgmtEpEltInqBegin 函式 (rpcdce.h)

  • 發行項

RpcMgmtEpEltInqBegin 函式會建立查詢內容，以檢視端點對應中的元素。

語法

RPC_STATUS RpcMgmtEpEltInqBegin(
  RPC_BINDING_HANDLE EpBinding,
  unsigned long      InquiryType,
  RPC_IF_ID          *IfId,
  unsigned long      VersOption,
  UUID               *ObjectUuid,
  RPC_EP_INQ_HANDLE  *InquiryContext
);

參數

EpBinding

系結句柄至要檢視其端點對應專案的主機。 指定 NULL 以檢視本機主機中的專案。 如果指定系結句柄，系結句柄上的物件 UUID 必須是 NULL。 如果有，則會忽略系結句柄上的端點，並使用指定主機上端點對應程式資料庫的端點。

InquiryType

整數值，表示在端點對應上執行的查詢類型。 以下是有效的查詢類型。

值 意義
RPC_C_EP_ALL_ELTS
 從端點對應傳回每個元素。 IfId、VersOption 和 ObjectUuid 參數會被忽略。
RPC_C_EP_MATCH_BY_IF
 在端點對應中搜尋包含 IfId 和 VersOption 值所指定介面識別碼的專案。
RPC_C_EP_MATCH_BY_OBJ
 在端點對應中搜尋包含 ObjectUuid 所指定物件 UUID 的專案。
RPC_C_EP_MATCH_BY_BOTH
 在端點對應中搜尋包含 IfId、 VersOption 和 ObjectUuid 所指定介面標識符和物件 UUID 的專案。

IfId

RpcMgmtEpEltInqNext 所傳回之端點對應專案的介面識別碼。 只有在 InquiryType 為 RPC_C_EP_MATCH_BY_IF 或 RPC_C_EP_MATCH_BY_BOTH 時，才會使用此參數。 否則會予以忽略。

VersOption

指定 RpcMgmtEpEltInqNext 如何使用 IfId 參數。 只有在 InquiryType 為 RPC_C_EP_MATCH_BY_IF 或 RPC_C_EP_MATCH_BY_BOTH 時，才會使用此參數。 否則會予以忽略。 以下是此參數的有效值。

值 意義
RPC_C_VERS_ALL
 傳回端點對應專案，提供指定的介面 UUID，不論版本號碼為何。
RPC_C_VERS_COMPATIBLE
 傳回端點對應專案，提供相同主要版本的指定介面 UUID 和大於或等於指定介面 UUID 次要版本的次要版本。
RPC_C_VERS_EXACT
 傳回端點對應專案，提供指定介面 UUID 的指定版本。
RPC_C_VERS_MAJOR_ONLY
 傳回端點對應專案，提供相同主要版本的指定介面 UUID ，並忽略次要版本。
RPC_C_VERS_UPTO
 傳回端點對應專案，提供小於或等於指定主要和次要版本的指定介面 UUID 版本。

ObjectUuid

RpcMgmtEpEltInqNext 在端點對應元素中尋找的物件 UUID。 只有當 InquiryType 是RPC_C_EP_MATCH_BY_OBJ或RPC_C_EP_MATCH_BY_BOTH時，才會使用此參數。

InquiryContext

傳回與 RpcMgmtEpEltInqNext 和 RpcMgmtEpEltInqDone 搭配使用的查詢內容。 請參閱 RPC_EP_INQ_HANDLE。

傳回值

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

備註

RpcMgmtEpEltInqBegin 函式會建立查詢內容，以檢視儲存在端點對應中的伺服器地址資訊。 使用 InquiryType 和 VersOption，應用程式會指定要從 RpcMgmtEpEltInqNext 呼叫傳回下列哪一個端點對應元素：

  • 所有項目
  • 具有指定介面識別碼的專案
  • 具有指定物件 UUID 的元素
  • 具有指定介面識別碼和物件 UUID 的專案
在呼叫 RpcMgmtEpEltInqNext 之前，應用程式必須先呼叫此函式來建立查詢內容。 檢視端點對應元素之後，應用程式會呼叫 RpcMgmtEpEltInqDone 來刪除查詢內容。

規格需求

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

另請參閱

RpcEpRegister

RpcMgmtEpEltInqDone

RpcMgmtEpEltInqNext