RpcNsBindingInqEntryName 函式 (rpcdce.h)

  • 發行項

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

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

語法

RPC_STATUS RpcNsBindingInqEntryName(
  RPC_BINDING_HANDLE Binding,
  unsigned long      EntryNameSyntax,
  RPC_CSTR           *EntryName
);

參數

Binding

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

EntryNameSyntax

EntryName 中使用的語法。

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

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

EntryName

傳回指向找到 Binding 之 name-service 資料庫專案名稱的指標位址。

指定 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 參數中指定的 系結句柄不是從 name-service 資料庫專案傳回 (，則如果系結句柄是由呼叫 RpcBindingFromStringBinding) 所建立， RpcNsBindingInqEntryName 會傳回空字串 (“\0”) 和RPC_S_NO_ENTRY_NAME狀態代碼。

規格需求

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

另請參閱

RpcBindingFromStringBinding

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcStringFree