共用方式為

RpcNsProfileEltInqNextA 函式 (rpcnsi.h)

  • 發行項

RpcNsProfileEltInqNext 函式會一次從配置檔傳回一個專案。

注意 Windows Vista 和更新版本的作業系統不支援此函式。
 

語法

RPC_STATUS RpcNsProfileEltInqNextA(
  RPC_NS_HANDLE InquiryContext,
  RPC_IF_ID     *IfId,
  RPC_CSTR      *MemberName,
  unsigned long *Priority,
  RPC_CSTR      *Annotation
);

參數

InquiryContext

從 RpcNsProfileEltInqBegin 函式傳回的名稱服務句柄。

IfId

傳回配置檔專案的介面識別指標。

MemberName

傳回配置文件項目成員名稱指標的指標。傳回名稱的語法是由 RpcNsProfileEltInqBegin 函式中的 MemberNameSyntax 參數所指定。

指定 Null 值以防止 RpcNsProfileEltInqNext 傳回 MemberName 參數。 在此情況下，應用程式不會呼叫 RpcStringFree 函式。

Priority

傳回 profile-element 優先權的指標。

Annotation

傳回配置文件專案之註釋字串指標的指標。 如果 profile 元素中沒有註釋字串，則會傳回字串 \0。

指定 Null 值以防止 RpcNsProfileEltInqNext 傳回 Annotation 參數。 在此情況下，應用程式不需要呼叫 RpcStringFree 函式。

傳回值

值 意義
RPC_S_OK
 呼叫成功。
RPC_S_INCOMPLETE_NAME
 名稱不完整。
RPC_S_NAME_SERVICE_UNAVAILABLE
 無法使用名稱服務。
RPC_S_NO_MORE_ELEMENTS
 沒有其他元素。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

備註

RpcNsProfileEltInqNext 函式會從 RpcNsProfileEltInqBegin 中 ProfileName 參數所指定的配置檔傳回一個專案。 不論 RpcNsProfileEltInqBegin 中的 InquiryType 值為何，RpcNsProfileEltInqNext 都會傳回設定檔專案 (介面識別、成員名稱、優先順序、批注字串) 的所有元件。

應用程式可以重複呼叫 RpcNsProfileEltInqNext 函式來檢視所有選取的配置檔專案。 當檢視所有元素時，此函式會傳回RPC_S_NO_MORE_ELEMENTS狀態代碼。 傳回的專案未排序。

在每次呼叫會傳回配置文件專案的 RpcNsProfileEltInqNext 時 ，RPC 運行時間連結庫會為傳回的成員名稱和註釋字串配置記憶體。 應用程式負責針對每個傳回的成員名稱和註釋字串呼叫 RpcStringFree 函式。 檢視配置檔的元素之後，應用程式必須呼叫 RpcNsProfileEltInqDone 以釋放查詢內容。

注意 Windows 2000 Active Directory 支援此函式。 舊版 Windows NT 僅支援搭配使用此函式與 Cell Directory Service (CDS) 。
 

注意

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

規格需求

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

另請參閱

RpcNsProfileEltInqBegin

RpcNsProfileEltInqDone

RpcStringFree