RpcNsBindingInqEntryNameW 函式（rpcdce.h）

發行項
11/20/2024

RpcNsBindingInqEntryName 函式會傳回系結句柄的來源項目名稱。

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

語法

RPC_STATUS RpcNsBindingInqEntryNameW(
  RPC_BINDING_HANDLE Binding,
  unsigned long      EntryNameSyntax,
  RPC_WSTR           *EntryName
);

參數

Binding

系結句柄，其 name-service 資料庫項目名稱會傳回。

EntryNameSyntax

EntryName中使用的語法。

若要使用登錄值專案中指定的語法

HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax，提供 RPC_C_NS_SYNTAX_DEFAULT 的值。

EntryName

傳回指向系結的名稱服務資料庫專案名稱的指標位址。

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

傳回值

價值	意義
RPC_S_OK	呼叫成功。
RPC_S_INVALID_BINDING	系結句柄無效。
RPC_S_NO_ENTRY_NAME	沒有系結的項目名稱。
RPC_S_INVALID_NAME_SYNTAX	名稱語法無效。
RPC_S_UNSUPPORTED_NAME_SYNTAX	不支援名稱語法。
RPC_S_INCOMPLETE_NAME	名稱不完整。

注意如需有效錯誤碼的清單，請參閱 RPC 傳回值。

言論

RpcNsBindingInqEntryName 函式會傳回用戶端兼容系結句柄從中傳回名稱 service-database 專案名稱的名稱。

RPC 執行時間連結庫會配置記憶體給 EntryName 參數中傳回的字串。應用程式負責呼叫 RpcStringFree 函式來解除分配該記憶體。

專案名稱只會與從 RpcNsBindingImportNext傳回的系結句柄相關聯，RpcNsBindingLookupNext和 RpcNsBindingSelect 函式。

如果 Binding 參數中指定的系結句柄未從名稱服務資料庫專案傳回（例如，如果系結句柄是由呼叫 RpcBindingFromStringBinding所建立），RpcNsBindingInqEntryName 會傳回空字串串（“\0”）和RPC_S_NO_ENTRY_NAME狀態代碼。

注意

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

要求

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