共用方式為

RpcNsEntryExpandNameW 函式 （rpcnsi.h）

  • 發行項

RpcNsEntryExpandName 函式會展開名稱服務項目名稱。 Active Directory 支援此函式。

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

語法

RPC_STATUS RpcNsEntryExpandNameW(
  unsigned long EntryNameSyntax,
  RPC_WSTR      EntryName,
  RPC_WSTR      *ExpandedName
);

參數

EntryNameSyntax

EntryName的語法。

若要使用登錄值專案 HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax中指定的語法，請提供 RPC_C_NS_SYNTAX_DEFAULT的值。

EntryName

要展開之專案名稱的指標。

ExpandedName

傳回 EntryName擴充版本的指標。

傳回值

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

言論

應用程式會呼叫 RpcNsEntryExpandName 函式，以取得完整展開的項目名稱。

RPC 執行時間連結庫會為傳回的 ExpandedName 參數配置記憶體。 應用程式負責呼叫傳回字串的 RpcStringFree 函式。

傳回的擴充專案名稱會用於本機名稱轉譯，以及本機定義命名架構的差異。

注意 此函式需要 Active Directory 支援。
 

注意

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

要求

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

另請參閱

RpcStringFree