共用方式為

RpcNsProfileEltInqNextW 函式 （rpcnsi.h）

  • 發行項

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

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

語法

RPC_STATUS RpcNsProfileEltInqNextW(
  RPC_NS_HANDLE InquiryContext,
  RPC_IF_ID     *IfId,
  RPC_WSTR      *MemberName,
  unsigned long *Priority,
  RPC_WSTR      *Annotation
);

參數

InquiryContext

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

IfId

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

MemberName

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

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

Priority

傳回配置檔項目優先權的指標。

Annotation

傳回配置文件專案之批註字串指標的指標。 如果配置檔元素中沒有註釋字串，則會傳回字串 \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 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 rpcnsi.h （包括 Rpc.h）
連結庫 Rpcns4.lib
DLL Rpcns4.dll

另請參閱

RpcNsProfileEltInqBegin

RpcNsProfileEltInqDone

RpcStringFree